🛑 문제 상황: 배포 환경에서 알림이 실시간으로 오지 않는다?!

배포 후 알림 서비스가 제대로 동작하지 않는다는 제보를 받았다. 로컬 환경에서는 멀쩡했는데, 배포 환경에서는 알림이 오지 않았다. 로컬에서는 Spring Boot WAS가 SSE 요청을 바로 처리했지만, 배포 환경에서는 Nginx가 중간에 끼어 있었다.

'이거 Nginx가 문제일 수도 있겠다...' 싶어서 설정 파일을 샅샅이 들여다보기로 했다.

AS-IS 설정

# Default server configuration
server {
    listen 80 default_server;
    listen [::]:80 default_server;

    server_name _;

    # HTTP 요청을 HTTPS로 리디렉션
    location / {
        return 301 https://$host$request_uri;
    }
}

server {
    listen 443 ssl;
    listen [::]:443 ssl ipv6only=on;
    server_name sharespace.store;

    root /var/www/html;

    ssl_certificate /etc/letsencrypt/live/sharespace.store/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/sharespace.store/privkey.pem;
    include /etc/letsencrypt/options-ssl-nginx.conf;
    ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem;

    location / {
        proxy_pass <http://127.0.0.1:8080>;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

# HTTP 요청을 HTTPS로 리디렉션 (특정 도메인)
server {
    if ($host = sharespace.store) {
        return 301 https://$host$request_uri;
    }

    listen 80;
    listen [::]:80;

    server_name sharespace.store;
    return 404;
}

뭔가 평범해 보이는 설정인데, 여기서 SSE의 특성을 고려하지 않은 점이 문제였다. SSE는 스트리밍 방식으로 데이터를 실시간으로 전송해야 한다. 하지만 Nginx는 기본적으로 데이터를 버퍼링한다. 이러면 실시간 전송이 막혀버린다.

수정 시작

1️⃣ proxy_buffering 끄기

SSE는 버퍼링이 필요 없다. 오히려 데이터가 버퍼에 쌓여 실시간 알림이 지연될 뿐이다. Nginx 설정에서 /notification/sse 경로에 대해 proxy_buffering off를 추가했다.

<aside>

❓ proxy_buffering이란?

proxy_buffering은 NGINX가 백엔드 서버로부터 받은 응답 데이터를 버퍼에 저장한 후, 클라이언트에게 전달하는 기능이다. 이 과정에서 모든 응답을 한 번에 받은 후 클라이언트로 전송하므로, 실시간 데이터 전송이 필요한 경우에는 적합하지 않다.

🔥 SSE와 proxy_buffering의 충돌

SSE는 데이터를 실시간 스트리밍 방식으로 클라이언트에 전송한다. 하지만 NGINX의 버퍼링이 활성화되어 있으면 데이터를 클라이언트로 즉시 보내지 않고 버퍼에 쌓았다가 전송하므로, 실시간성이 사라진다.

</aside>

2️⃣ chunked_transfer_encoding 끄기

Nginx는 기본적으로 HTTP/1.1의 청크 전송을 활성화한다. 하지만 SSE는 자체적으로 스트리밍을 처리하므로 청크 전송을 끄는 것이 더 안정적이다.

<aside>

❓ chunked_transfer_encoding이란?

HTTP/1.1의 청크 전송 방식으로, 응답 데이터를 작은 청크(chunk) 단위로 나누어 클라이언트로 전송하는 방식이다. 데이터를 전송할 때 각 청크의 크기를 명시하며, 데이터가 끝날 때까지 청크를 계속 보내는 구조이다.

🔥 SSE와 chunked_transfer_encoding의 문제

SSE는 자체적으로 데이터를 스트리밍하기 때문에 청크 전송 방식을 사용할 필요가 없다. NGINX가 이 방식을 강제로 적용하면 클라이언트가 데이터를 제대로 처리하지 못하거나 연결이 끊기는 등의 문제가 발생할 수 있다.

</aside>

3️⃣ Connection 헤더 설정

SSE는 클라이언트와 서버 간 장시간 연결을 유지해야 한다. 이를 위해 Connection 헤더를 비워서(빈 문자열) 명시적으로 설정했다.

4️⃣ 타임아웃 설정

기본 타임아웃은 너무 짧아서 SSE 연결이 자꾸 끊길 가능성이 있었다. 이를 방지하기 위해 proxy_read_timeout과 keepalive_timeout을 300초로 늘렸다.

5️⃣ 캐싱 방지

실시간 알림 데이터는 캐싱되면 안 된다. 그래서 Cache-Control 헤더를 통해 캐싱을 방지했다.