含义
请求头太大,可能是某一个请求头过大,也可能是所有请求头加起来过大。
常见原因
- 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 修改。