• Knowledge

실시간 업데이트에는 SSE와 WebSocket 중 무엇을 선택할까?

서버 이벤트를 전달하는 SSE와 양방향 메시지를 주고받는 WebSocket의 차이와 연결 관리 방법을 살펴봅니다.

시리즈15편 중 3편백엔드 통신의 흐름1부 · 서버와 클라이언트는 어떻게 대화할까?
1부 · 서버와 클라이언트는 어떻게 대화할까?3편
  1. 01HTTP 요청과 동기·비동기 실행은 어떻게 다를까?
  2. 02오래 걸리는 작업은 어떻게 기다릴까? Short Polling과 Long Polling
  3. 03실시간 업데이트에는 SSE와 WebSocket 중 무엇을 선택할까?읽는 중
2부 · HTTP 요청 아래에서는 무슨 일이 일어날까?6편
  1. 04TCP와 UDP는 무엇이 다를까? 바이트 스트림과 데이터그램
  2. 05TCP 연결은 성공했는데 서버 응답은 왜 늦을까?
  3. 06HTTPS는 어떻게 서버를 확인하고 통신을 암호화할까?
  4. 07HTTP/1.1은 TCP 연결을 어떻게 재사용할까?
  5. 08HTTP/2는 여러 요청을 어떻게 하나의 연결에 담을까?
  6. 09HTTP/3는 왜 QUIC을 사용할까?
3부 · 서비스에 맞는 통신 방식 선택하기3편
  1. 10gRPC는 서로 다른 서비스를 어떻게 연결할까?
  2. 11WebRTC는 브라우저 사이의 연결 경로를 어떻게 찾을까?
  3. 12서버를 늘리면 왜 로그인 상태가 사라질까?
4부 · 서버는 수많은 연결을 어떻게 감당할까?3편
  1. 13요청이 많아지면 스레드도 그만큼 필요할까?
  2. 14L4와 L7 로드 밸런서는 요청을 어떻게 분산할까?
  3. 15Sidecar 프록시는 서비스 간 통신에서 무엇을 할까?
실시간 업데이트가 필요하다는 이유만으로 양방향 연결을 선택할 필요는 없다

관리자 페이지에서 여러 서버의 배포 진행률을 보여 준다고 해볼게요. 사용자는 페이지를 열어 두고 있고, 서버는 진행률이 바뀔 때마다 숫자를 갱신해 줘야 합니다.

이런 기능을 만들려고 하면 흔히 WebSocket부터 떠올립니다. 하지만 브라우저가 서버로 실시간 메시지를 계속 보낼 필요가 없다면 SSE(Server-Sent Events)도 충분한 선택지가 될 수 있어요. SSE는 서버에서 브라우저로 이벤트를 전달하고, WebSocket은 같은 연결에서 양쪽이 메시지를 보낼 수 있습니다.

HTTP 응답을 끝내지 않고 이벤트를 계속 보낼 수 있다

일반적인 HTTP API는 요청을 받고 하나의 응답 본문을 보낸 다음 응답을 마칩니다. 하지만 응답 본문을 한 번에 끝낼 필요는 없어요. SSE는 text/event-stream 형식으로 열린 HTTP 응답에 여러 이벤트를 차례로 기록합니다.

브라우저는 처음 한 번 서버에 연결합니다.

javascript
const events = new EventSource('/deployments/d-42/events');

events.addEventListener('progress', (event) => {
  const progress = JSON.parse(event.data);
  console.log(`배포 진행률: ${progress.percent}%`);
});

events.addEventListener('completed', () => {
  console.log('배포 완료');
  events.close();
});

이 클라이언트 코드가 동작하려면 서버가 같은 경로에서 SSE 응답을 보내야 합니다. 아래는 서버가 전송할 수 있는 HTTP 메시지 형식의 예시예요.

Plain Text
HTTP/1.1 200 OK
Content-Type: text/event-stream
Cache-Control: no-cache

id: 41
event: progress
data: {"percent":30}

id: 42
event: progress
data: {"percent":65}

id: 43
event: completed
data: {"status":"completed"}

이벤트 사이에는 빈 줄이 있습니다. 브라우저는 빈 줄을 기준으로 하나의 이벤트가 끝났다고 판단해요. event:는 이벤트 이름이고, data:는 전달할 데이터입니다. 이벤트 이름을 지정하지 않으면 기본 message 이벤트로 처리할 수 있어요.

서버는 진행률이 바뀔 때마다 새로운 이벤트를 보낼 수 있습니다. 브라우저가 GET /deployments/d-42/events를 매번 새로 호출하는 것은 아니에요. 서버는 처음 열린 응답에 데이터를 이어서 씁니다.

이때 서버가 HTTP 응답을 계속 열어 놓을 수 있도록 구현해야 하고, 앞단 프록시가 데이터를 모아서 한꺼번에 보내지 않도록 버퍼링 설정도 확인해야 합니다. 서버가 이벤트를 기록해도 프록시가 늦게 전달하면 브라우저에는 실시간으로 보이지 않을 수 있어요.

SSE에서는 HTTP 응답 하나가 열려 있는 동안 여러 이벤트가 순서대로 전달된다

연결이 끊어졌을 때 SSE는 어떻게 이어받을까?

장시간 연결을 유지하다 보면 Wi-Fi가 끊기거나 프록시가 유휴 연결을 닫을 수 있습니다. 브라우저의 EventSource는 재연결이 가능한 조건에서 자동으로 다시 연결을 시도해요.

위 예시에 있는 id: 41, id: 42, id: 43이 여기서 사용됩니다. 브라우저가 마지막으로 처리한 이벤트 ID를 기억하고 있다면, 재연결할 때 Last-Event-ID 요청 헤더에 그 값을 실어 보낼 수 있습니다.

예를 들어 42번 이벤트까지 받은 뒤 연결이 끊어졌다면 서버는 다음과 같은 요청을 받을 수 있어요.

Plain Text
GET /deployments/d-42/events HTTP/1.1
Last-Event-ID: 42

하지만 브라우저가 마지막 ID를 전달한다고 서버가 43번부터 자동으로 복구해 주는 것은 아닙니다. 서버가 이벤트 이력을 저장해 두고, 해당 ID 이후의 이벤트를 다시 보낼 수 있도록 구현해야 해요. 이력이 없거나 보존 기간을 지났다면 현재 상태를 다시 조회하도록 설계할 수 있습니다.

또한 브라우저가 새 EventSource 객체를 만들 때 이전 객체의 마지막 ID가 저절로 이어지는 것도 아니에요. 자동 재연결은 같은 EventSource 객체가 연결을 복구할 때의 동작입니다. 앱을 새로 열거나 페이지를 새로 고치는 상황까지 복구하려면 별도의 상태 관리가 필요합니다.

SSE가 끊겼다가 돌아왔다고 모든 이벤트가 정확히 한 번씩 전달되었다고 가정하면 안 됩니다. 진행률 숫자처럼 최신 상태로 덮어써도 되는 정보와, 놓치면 안 되는 결제 결과 같은 정보는 복구 전략이 달라야 합니다.

WebSocket은 한 연결에서 양쪽이 메시지를 보낸다

이번에는 배포 현황 대신 채팅을 만든다고 해보죠. 사용자는 메시지를 보내고, 서버도 다른 사람의 메시지를 곧바로 전달해야 합니다. 이런 형태라면 WebSocket이 더 자연스럽습니다.

WebSocket은 연결을 수립할 때 HTTP 기반 핸드셰이크를 사용합니다. HTTP/1.1 Upgrade 방식을 쓰는 경우 서버는 연결 전환을 허용한다는 101 Switching Protocols 응답을 돌려주고, 이후 양쪽이 WebSocket 메시지를 주고받습니다. HTTP/2 등에서는 연결 수립 방식이 다를 수 있으므로 언제나 101만 사용한다고 생각하면 안 됩니다.

브라우저의 WebSocket 클라이언트는 다음처럼 작성할 수 있습니다. 연결할 WebSocket 서버가 따로 구현되어 있다고 가정한 클라이언트 코드예요.

javascript
const socket = new WebSocket('wss://example.com/chat');

socket.addEventListener('open', () => {
  socket.send(JSON.stringify({ type: 'join', room: 'backend' }));
});

socket.addEventListener('message', (event) => {
  const message = JSON.parse(event.data);
  console.log(message);
});

WebSocket에서는 같은 연결을 통해 클라이언트가 join 메시지를 보내고 서버가 다른 메시지를 보낼 수 있습니다. 반면 브라우저의 기본 EventSource는 서버→브라우저 방향 이벤트 스트림을 받는 API예요. SSE를 사용해도 브라우저에서 서버로 데이터를 보낼 수는 있지만, 그때는 별도의 fetch()나 POST 요청을 사용해야 합니다.

서버 이벤트만 받아야 한다면 SSE로 충분하고 양방향 메시지가 필요할 때 WebSocket의 구조가 유리하다

실시간 통신에서도 연결 수와 데이터 속도가 문제다

SSE와 WebSocket 모두 오랫동안 연결을 유지한다는 비용이 있습니다. 서버뿐 아니라 로드 밸런서와 프록시에서도 연결 유지 시간, 유휴 타임아웃, 동시 접속자 수를 확인해야 해요.

특히 HTTP/1.1 환경에서 브라우저의 SSE 연결은 브라우저와 출처별 연결 수 제한의 영향을 받을 수 있습니다. 브라우저 여러 탭에서 각각 SSE 연결을 열면 이 제한을 생각보다 빨리 만날 수도 있어요. HTTP/2에서는 하나의 연결 위에 여러 스트림을 실을 수 있지만, 동시 스트림 수 역시 협상된 제한을 따릅니다.

반대로 WebSocket을 쓴다고 연결 관리 문제가 사라지는 것은 아닙니다. 브라우저의 일반적인 WebSocket API는 메시지 처리 속도에 맞춰 수신량을 자동 조절하는 backpressure를 제공하지 않아요. 이벤트가 너무 빨리 쌓이면 애플리케이션의 메모리 사용량이나 반응성에 문제가 생길 수 있습니다. 필요한 데이터만 보내거나 서버 쪽 전송 속도를 제한하고, 늦은 클라이언트를 처리하는 규칙을 마련해야 합니다.

또 하나는 인증입니다. 브라우저 기본 EventSource 생성자에는 임의의 HTTP 요청 헤더를 지정하는 옵션이 없습니다. 쿠키 기반 인증을 쓸 수 있지만, 커스텀 Authorization 헤더가 반드시 필요한 API라면 다른 클라이언트 구현이나 인증 방식을 고려해야 해요. WebSocket도 브라우저 API의 핸드셰이크 헤더 제어에는 제약이 있으므로 인증 설계는 별도로 검토해야 합니다.

진행률 알림이라면 무엇을 선택해야 할까?

처음의 배포 진행률 화면으로 돌아가 봅시다. 사용자가 버튼으로 배포를 시작하는 요청은 평범한 HTTP POST로 보내고, 진행률은 서버가 바뀔 때마다 알려 주면 됩니다. 같은 연결을 통해 브라우저가 계속 명령을 보낼 필요가 없다면 SSE가 간단하고 충분해요.

채팅처럼 양쪽이 자주 메시지를 주고받고 같은 연결을 재사용해야 한다면 WebSocket을 선택할 이유가 더 분명해집니다. 업데이트가 드물고 실시간성이 크게 중요하지 않다면 주기적인 Polling이 운영상 더 단순할 수도 있어요.

결론은 전송 속도보다 데이터가 오가는 방향에 있습니다. 서버에서 오는 변경 사항을 받기만 하면 되는지, 클라이언트와 서버가 같은 연결에서 계속 대화해야 하는지를 먼저 구분하면 SSE와 WebSocket 중 무엇을 사용할지 훨씬 쉽게 결정할 수 있습니다.

댓글 0

이 글에 대한 생각을 자유롭게 남겨주세요.

댓글 관련 문의

댓글을 불러오는 중…

갑자기 추워진 날, 진주에서

진주에서 하루종일 돌아다녔다

양승민

내 단점을 커버하는 동료와 함께.

새로운 프로젝트를 함께 준비하는 친구와의 저녁. 미운 점도 고마운 점도 있지만, 결국 같이 잘됐으면 좋겠다는 마음.

양승민

순천과 여수 여행3

마지막 하루. 공부랑 런닝으로 끝내기

양승민
See all