본문으로 건너뛰기

WebSocket (개발자 관점)

전이중 장기 접속입니다. HTTP의 '한 번 보내고 한 번 받기'와 달리, WS는 먼저 연결을 수립한 뒤 언제든 프레임을 주고받고, 마지막에 닫습니다.

UI에서의 사용법​

  1. WebSocket 요청을 만듭니다: URL은 완전한 주소를 받습니다(ws://…/ws/echo 또는 wss://…/path). 핸드셰이크 헤더는 요청 헤더에 넣습니다.
  2. 연결을 탭해 세션을 수립합니다.
  3. 세션에서 입력하고 전송합니다. 수신 프레임은 실시간으로 표시됩니다.
  4. 끝나면 세션을 닫습니다(세션에는 쿼터가 있고, 아이들 세션은 자동 회수됩니다).

평문 vs 암호화​

  • ws://는 평문, wss://는 TLS입니다.
  • 환경의 WS Pre-URL을 거친다면, 그 베이스 주소는 반드시 ws:///wss://로 작성해야 합니다 — https://는 HTTP로 취급됩니다(concepts 참조).

검증된 동작​

텍스트 프레임은 UTF-8 무손상으로 왕복합니다(hello-ws-世界 송수신 동일). /ws/headers는 핸드셰이크 때 보낸 헤더를 에코로 돌려주므로 적용 확인이 쉽습니다. 서브프로토콜·압축·하트비트는 자동화 테스트 케이스가 커버합니다.

주의 사항​

  • 에코가 수신되지 않음: 서버가 실제로 응답하는지 확인하세요. 장기 접속에서 '전송'은 내보내기만 합니다 — 응답은 나중에 수신 프레임으로 도착합니다.
  • 보내지 않고 관찰만 하고 싶을 때: 연결 후 들어오는 프레임을 볼 수 있습니다(예: 서버 푸시).
  • 세션 쿼터는 제한적이고, 아이들 세션은 약 5분 후 닫힙니다. 배치로 디버깅할 때는 오래된 세션을 즉시 닫으세요.

관련: 연결/전송 UI 설정은 concepts.