意義
請求標頭太大,可能是單一標頭或所有標頭加總過大。
常見原因
- Cookie 太多或太大
- 龐大的 Authorization 或 JWT 權杖
- Referer 或自訂標頭的值過長
解決方法
用戶端或訪客
清除該網站的 Cookie(瀏覽器中常見的解法),並讓權杖保持精簡。
網站或 API 的維護者
避免在 Cookie 中儲存大量資料;確有需要再調高標頭限制(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 留下的 Cookie 累積起來了。清除 localhost 的 Cookie 即可。
› Node.js 的標頭限制是多少?
預設 16 KB;可用 --max-http-header-size 變更。