Rust axum 0.8 + tokio로 SSE 엔드포인트를 만들었습니다. Stream을 반환하는 핸들러인데, 클라이언트가 약 30초 동안 이벤트를 못 받으면 connection이 끊깁니다.
nginx reverse proxy를 통과하고 있고, proxy_read_timeout은 600초로 늘렸습니다. 그런데도 axum 내부에서 끊는 듯합니다. 원인이 뭘까요?
Rust axum 0.8 + tokio로 SSE 엔드포인트를 만들었습니다. Stream을 반환하는 핸들러인데, 클라이언트가 약 30초 동안 이벤트를 못 받으면 connection이 끊깁니다.
nginx reverse proxy를 통과하고 있고, proxy_read_timeout은 600초로 늘렸습니다. 그런데도 axum 내부에서 끊는 듯합니다. 원인이 뭘까요?
댓글 1
axum 0.8 + reverse proxy 환경의 흔한 SSE 함정입니다. 원인은 보통 (1) keep-alive 미설정 + (2) hyper의 idle timeout + (3) proxy buffering 세 갈래가 맞물립니다.
1) axum SSE에 keep-alive 명시 (가장 자주 빠뜨림)
30초 침묵하면 끊긴다는 것은 거의 항상 keep-alive 누락 또는 interval이 너무 큼입니다. 15초 권장.
2) hyper의 idle timeout 점검
이 기본 setup에서는 hyper가 idle timeout을 강제하지 않지만, 일부 0.8 마이너 버전에서 30~60초 default가 깔린 적이 있습니다. 명시 권장:
3) nginx 측 SSE 친화 설정
특히
proxy_buffering off가 빠져있으면 nginx가 응답을 모았다 보내서 SSE가 의미를 잃습니다.4) Cloudflare·로드밸런서
중간에 CDN/LB가 있으면 별도 설정이 필요합니다.
5) 클라이언트 측 — 자동 재연결
SSE는 본질적으로 끊김에 강하도록 설계됐습니다. 어쨌든 끊겨도 client가 재연결합니다.
서버 측에서:
이러면 재연결 시 client가
Last-Event-ID헤더를 보내서 어디서부터 이어 받을지 알릴 수 있습니다.6) 디버깅 — 어디서 끊어지는지 정확히 찍기
실무 체크리스트
keep_alive(KeepAlive::new().interval(15s))명시proxy_buffering off,proxy_read_timeout충분히 길게"30초마다 끊긴다"는 거의 항상 keep-alive 누락 또는 proxy buffering입니다. 위 두 항목부터 점검하세요.