DevToolPal
简
4xx 客户端错误

431 Request Header Fields Too Large

请求头字段过大

含义

请求头太大,可能是某一个请求头过大,也可能是所有请求头加起来过大。

常见原因

  • 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

规范

RFC 6585 §5

常见问题

› 为什么 localhost 返回 431?

多个开发项目在 localhost 上留下的 Cookie 累积起来了。清除 localhost 的 Cookie 即可。

› Node.js 的请求头限制是多少?

默认 16 KB;可以用 --max-http-header-size 修改。