Request Header Fields Too Large

개요

431 Request Header Fields Too Large는 요청 헤더가 개별적으로 또는 전체적으로 서버가 허용하는 크기를 넘었다는 뜻입니다. 가장 흔한 범인은 지나치게 커진 쿠키와 비대한 Authorization/커스텀 헤더입니다.

많은 서버는 헤더 전체를 담는 버퍼 크기(보통 8~16KB)를 제한합니다. 세션에 데이터를 잔뜩 쌓아 쿠키가 커지거나, 여러 서드파티 쿠키가 누적되면 이 한도를 넘겨 431이 발생합니다.

언제 발생하나

• 쿠키가 누적되어 헤더 전체 크기가 서버 한도를 초과했을 때
• 매우 긴 JWT/토큰을 Authorization 헤더에 실었을 때
• 커스텀 헤더나 Referer가 지나치게 길 때

요청 / 응답 예시

GET /dashboard HTTP/1.1
Host: app.example.com
Cookie: session=...<50 KB of cookies>...
Authorization: Bearer <very long token>

HTTP/1.1 431 Request Header Fields Too Large
Content-Type: text/plain

One or more header fields exceed the allowed size.

코드로 보기

# Raise buffers that hold large headers/cookies (or reduce cookie size instead)
server {
  large_client_header_buffers 4 32k;
}

# See exactly which headers are being sent (look for bloated Cookie)
curl -v https://app.example.com/dashboard 2>&1 | grep -i '^> '

실무 참고

• 431은 특정 URL에서만 재현되기도 하는데, 이는 그 도메인에 쌓인 쿠키 때문일 수 있습니다. 시크릿 모드로 접속하면 원인을 빠르게 가릴 수 있습니다.
• 본문(body)이 아니라 헤더가 문제라는 점에서 413 Content Too Large와 구분됩니다.

관련 상태코드

관련 헤더

스펙 근거