Request Timeout

개요

408 Request Timeout은 서버가 클라이언트로부터 완전한 요청을 받기까지 기다리다가 제한 시간을 넘겨 연결을 정리했음을 뜻합니다. 클라이언트가 요청 라인·헤더·본문을 너무 느리게 보내는 것이 원인입니다.

서버 내부나 업스트림 처리가 느린 504 Gateway Timeout과 달리, 408은 요청을 "보내는" 쪽(클라이언트)이 느린 경우라는 점이 핵심 차이입니다.

언제 발생하나

• 느리거나 불안정한 네트워크에서 클라이언트가 요청 본문을 제때 전송하지 못할 때 반환됩니다.
• 커넥션 풀이 미리 열어 둔 유휴 연결을 서버가 타임아웃으로 닫으면서 408을 보내는 경우도 있습니다.

요청 / 응답 예시

POST /upload HTTP/1.1
Host: example.com
Content-Length: 5000000

(client stalls; body never fully arrives within the server's timeout)

HTTP/1.1 408 Request Timeout
Connection: close
Content-Type: text/html

<h1>Request Timeout</h1>

코드로 보기

# server waits this long for the client to send the request body
client_body_timeout 12s;
client_header_timeout 12s;  # slow clients -> 408

실무 참고

• 규격상 408 응답에는 Connection: close가 함께 오는 경우가 많으며, 이는 클라이언트가 새 연결로 재시도하라는 신호입니다.
• 브라우저는 408을 받으면 종종 요청을 자동으로 한 번 재시도합니다.
• TLS early-data(0-RTT) 요청을 안전상 거부하는 경우는 408이 아니라 425 Too Early가 쓰입니다.

관련 상태코드

관련 헤더

스펙 근거