본문 바로가기
Q&A해결2026년 4월 25일1분 읽기

Rust axum에서 SSE 스트림이 200 응답 대기로 끊깁니다

R
Rust초보
조회 423댓글 1

Rust axum 0.8 + tokio로 SSE 엔드포인트를 만들었습니다. Stream을 반환하는 핸들러인데, 클라이언트가 약 30초 동안 이벤트를 못 받으면 connection이 끊깁니다.

nginx reverse proxy를 통과하고 있고, proxy_read_timeout은 600초로 늘렸습니다. 그런데도 axum 내부에서 끊는 듯합니다. 원인이 뭘까요?

댓글 1

김김영삼7개월 전

axum 0.8 + reverse proxy 환경의 흔한 SSE 함정입니다. 원인은 보통 (1) keep-alive 미설정 + (2) hyper의 idle timeout + (3) proxy buffering 세 갈래가 맞물립니다.

1) axum SSE에 keep-alive 명시 (가장 자주 빠뜨림)

use axum::response::sse::{Event, KeepAlive, Sse};
use std::time::Duration;
use futures::stream::Stream;

async fn sse_handler() -> Sse<impl Stream<Item = Result<Event, Infallible>>> {
let stream = your_event_stream();

Sse::new(stream)
.keep_alive(
KeepAlive::new()
.interval(Duration::from_secs(15))
.text("keep-alive"),
)
}

30초 침묵하면 끊긴다는 것은 거의 항상 keep-alive 누락 또는 interval이 너무 큼입니다. 15초 권장.

2) hyper의 idle timeout 점검

let app = Router::new().route("/sse", get(sse_handler));

let listener = TcpListener::bind("0.0.0.0:3000").await?;
axum::serve(listener, app)
.with_graceful_shutdown(shutdown_signal())
.await?;

이 기본 setup에서는 hyper가 idle timeout을 강제하지 않지만, 일부 0.8 마이너 버전에서 30~60초 default가 깔린 적이 있습니다. 명시 권장:

use hyper_util::server::conn::auto::Builder;
use hyper_util::rt::TokioExecutor;

// 더 세밀한 제어가 필요하면 hyper-util 직접 사용
let builder = Builder::new(TokioExecutor::new())
.http1()
.keep_alive(true)
.keep_alive_interval(Some(Duration::from_secs(15)));

3) nginx 측 SSE 친화 설정

location /sse/ {
proxy_pass http://upstream;
proxy_http_version 1.1;
proxy_set_header Connection "";

# SSE 핵심
proxy_buffering off; # 버퍼링 절대 안 됨
proxy_cache off;
chunked_transfer_encoding on;

# 타임아웃
proxy_read_timeout 24h; # 사실상 무한
proxy_send_timeout 24h;
}

특히 proxy_buffering off가 빠져있으면 nginx가 응답을 모았다 보내서 SSE가 의미를 잃습니다.

4) Cloudflare·로드밸런서

중간에 CDN/LB가 있으면 별도 설정이 필요합니다.

  • Cloudflare: SSE는 100초 한계 (Free), Pro+ 플랜에서 SSE 지원 강화
  • AWS ALB: idle_timeout 설정 (기본 60초 → 4000초까지 가능)
  • GCP LB: 30초 기본 → backend service의 timeoutSec 늘리기

5) 클라이언트 측 — 자동 재연결

SSE는 본질적으로 끊김에 강하도록 설계됐습니다. 어쨌든 끊겨도 client가 재연결합니다.

const evt = new EventSource('/sse')
evt.onerror = (e) => {
console.log('reconnecting...')
// 브라우저가 자동 재시도 (3초 간격)
}

// 마지막 이벤트 ID 활용 (서버가 ID를 보내야 함)
evt.onmessage = (e) => {
console.log('id:', e.lastEventId)
}

서버 측에서:

let event = Event::default()
.id(format!("{}", counter))
.data(payload);

이러면 재연결 시 client가 Last-Event-ID 헤더를 보내서 어디서부터 이어 받을지 알릴 수 있습니다.

6) 디버깅 — 어디서 끊어지는지 정확히 찍기

# 1) axum이 보내는지 확인
curl -N http://localhost:3000/sse # 직접 — keep-alive 보이는지

# 2) nginx 통과 후 확인
curl -N https://api.example.com/sse # 30초 동안 hang 없는지

# 3) 브라우저 콘솔
# Network 탭의 EventSource 응답 stream에 keep-alive comment 보이는지

실무 체크리스트

  1. axum Sse에 keep_alive(KeepAlive::new().interval(15s)) 명시
  2. nginx proxy_buffering off, proxy_read_timeout 충분히 길게
  3. 중간 LB·CDN의 idle timeout 명시 변경
  4. Event에 ID 부여 — 재연결 시 이어받기 가능
  5. 프로덕션에서는 SSE 대신 WebSocket 또는 HTTP/2 Server Push 검토 — 양방향·다중 stream 가능

"30초마다 끊긴다"는 거의 항상 keep-alive 누락 또는 proxy buffering입니다. 위 두 항목부터 점검하세요.

Ctrl+Enter로 등록