Nginx 默认 large_client_header_buffers 为 4 8k，超长请求头易触发400错误；可通过配置查找、nginx -T 或 debug 日志确认；常见于大 Cookie、SSR、OAuth2 及多层代理场景；建议调至 4 16k 并同步调整 client_header_buffer_size，优先从源头精简 Header。
安装 Nginx 后，默认的 large_client_header_buffers 值通常为 4 8k（即 4 个缓冲区，每个 8KB），适用于大多数标准 HTTP 请求头。但当客户端发送超长请求头（如含大量 Cookie、自定义 Header 或 JWT Token）时，可能触发 400 Bad Request 错误，提示 “Request Header Or Cookie Too Large”。
如何确认当前 large_client_header_buffers 设置
可在 Nginx 配置中查找该指令位置（通常在 http、server 或 location 块内）：
- 若配置文件中未显式设置，则使用编译时默认值：4 8k
- 可通过
nginx -T | grep large_client_header_buffers查看生效值（注意大小写） - 也可临时添加
error_log /var/log/nginx/error.log debug;并触发一次大 header 请求，从错误日志中观察是否出现 “client sent too large header” 提示
常见需要调大的场景
以下情况容易超出默认 8KB 限制：
- 单个 Cookie 超过 4KB（尤其多个 domain 共享的长 Token）
- 前端框架（如 Next.js、Nuxt）在 SSR 中注入大量调试或上下文 Header
- OAuth2 或 OpenID Connect 流程携带长 Authorization 或 X-Forwarded-* 链路头
- 反向代理链路中（如 Nginx → Nginx → 应用），上游不断追加 Header 导致累积膨胀
安全且实用的调整建议
不建议盲目设为“越大越好”，需兼顾性能与防护：
- 一般业务可设为
large_client_header_buffers 4 16k;（总容量 64KB） - 若明确需支持超长 JWT（如含完整用户权限声明），可尝试
4 32k，但应配合应用层做 Token 精简 - 务必同步检查
client_header_buffer_size（默认 1k），它影响首块缓冲；建议设为2k或4k，避免首块就溢出 - 修改后运行
nginx -t校验语法，再nginx -s reload生效
替代方案：从源头控制头部长度
比单纯调大缓冲更可持续的做法：
- 后端服务主动压缩或分片传输敏感上下文（如用 short token 换取 server-side session）
- Nginx 使用
proxy_set_header清理无用 Header（如去掉X-Debug-*、User-Agent等非必要字段） - 在入口层（如 CDN 或前置 LB）截断/拒绝明显异常的超长 Header（如单个 Cookie > 8KB）
