의미
요청 헤더가 너무 큽니다. 헤더 하나가 크거나, 전체 헤더 합이 큽니다.
흔한 원인
- 쿠키가 너무 많거나 큼
- 거대한 Authorization이나 JWT 토큰
- 값이 긴 Referer나 사용자 정의 헤더
해결 방법
클라이언트 또는 방문자라면
해당 사이트의 쿠키를 지우고(브라우저에서 흔한 해결책) 토큰을 작게 유지하세요.
사이트나 API 운영자라면
쿠키에 큰 데이터를 저장하지 말고, 필요할 때만 헤더 제한(Node.js --max-http-header-size, nginx large_client_header_buffers)을 올리세요.
응답 예시
HTTP/1.1
HTTP/1.1 431 Request Header Fields Too Large
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Content-Length: 0명세
자주 묻는 질문
› localhost가 431을 반환하는 이유는?
localhost의 여러 개발 앱 쿠키가 쌓였습니다. localhost 쿠키를 지우세요.
› Node.js의 헤더 제한은?
기본 16 KB이며 --max-http-header-size로 바꿀 수 있습니다.