의미
서버가 응답을 보내기 전에 클라이언트가 연결을 닫으면 nginx가 499를 기록합니다. 클라이언트는 이 코드를 보지 못합니다.
흔한 원인
- 사용자가 페이지를 떠나거나 요청을 취소함
- 클라이언트 타임아웃이 서버 처리 시간보다 짧음
- 로드 밸런서 헬스 체크 타임아웃
해결 방법
클라이언트 또는 방문자라면
요청이 정당하게 느리다면 클라이언트나 로드 밸런서의 타임아웃을 늘리세요.
사이트나 API 운영자라면
느린 엔드포인트를 빠르게 하고 업스트림 지연을 살펴보세요. 반드시 끝나야 하는 작업에는 proxy_ignore_client_abort를 고려하세요.
응답 예시
HTTP/1.1
HTTP/1.1 499 Client Closed Request
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Content-Length: 0명세
IANA 레지스트리에 없는 코드로, nginx에서 사용합니다.
자주 묻는 질문
› 499는 공식 상태 코드인가요?
아닙니다. nginx 로그용 코드이며 네트워크로 전송되지 않습니다.
› nginx 로그에 499가 많은 이유는?
클라이언트나 업스트림 로드 밸런서가 먼저 포기하고 있습니다. 그들의 타임아웃과 응답 시간을 비교하세요.