Switching Protocols

개요

101 Switching Protocols는 클라이언트가 Upgrade 헤더로 요청한 프로토콜 전환에 서버가 동의했음을 뜻합니다. 이 응답 이후 같은 TCP 연결은 더 이상 일반 HTTP가 아니라 협상된 새 프로토콜로 통신합니다.

현실에서 가장 흔한 용도는 HTTP에서 WebSocket으로의 업그레이드입니다. 응답의 Sec-WebSocket-Accept 값은 클라이언트가 보낸 키를 검증한 결과로, 이때부터 양방향 실시간 통신이 시작됩니다.

언제 발생하나

• 브라우저가 WebSocket 연결을 열 때 Connection: Upgrade와 Upgrade: websocket 헤더로 핸드셰이크를 시작하면, 서버가 이를 수락하며 101을 반환합니다.
• HTTP/1.1에서 h2c(암호화되지 않은 HTTP/2)로 업그레이드하는 등, 드물게 다른 프로토콜 전환에도 사용됩니다.

요청 / 응답 예시

GET /chat HTTP/1.1
Host: example.com
Connection: Upgrade
Upgrade: websocket
Sec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==
Sec-WebSocket-Version: 13

HTTP/1.1 101 Switching Protocols
Upgrade: websocket
Connection: Upgrade
Sec-WebSocket-Accept: s3pPLMBiTxaQ9kYGzzhZRbK+xOo=

코드로 보기

const ws = new WebSocket('wss://example.com/chat');
ws.onopen = () => ws.send('hello');
// the 101 handshake happens transparently before onopen

import { WebSocketServer } from 'ws';
const wss = new WebSocketServer({ port: 8080 });
wss.on('connection', s => s.send('welcome')); // library sends 101

실무 참고

• 101 이후 연결은 요청/응답 모델을 벗어나므로, 표준 HTTP 클라이언트나 curl로는 그 뒤의 트래픽을 그대로 관찰하기 어렵습니다.
• 서버가 업그레이드를 지원하지 않으면 101 대신 200으로 일반 응답을 주거나, 특정 프로토콜을 강제할 때는 426 Upgrade Required를 보냅니다.
• WebSocket 핸드셰이크에는 Sec-WebSocket-Key(요청)와 Sec-WebSocket-Accept(응답)의 짝이 반드시 맞아야 연결이 성립합니다.

관련 상태코드

관련 헤더

스펙 근거