核心是协同配置client_header_buffer_size和large_client_header_buffers：前者设为4k或8k（≤后者单buffer大小），后者如4 16k以容纳整行cookie；http/2还需额外设置http2_max_field_size和http2_max_header_size，并置于server块顶层。
在 server 块中处理超大 Cookie 引发的溢出报错，核心是让 Nginx 能完整接收并解析整行 Cookie 字符串（如含长 JWT、多段 SSO Token 或埋点字段），避免返回 400 Bad Request 或 414 URI Too Long。关键不是单调一个参数，而是两个缓冲指令协同生效，并确保配置位置正确。
必须同时设置 client_header_buffer_size 和 large_client_header_buffers
Cookie 是以完整一行（Cookie: xxx）发送的，Nginx 不会跨 buffer 拆分它。因此：
- client_header_buffer_size 设为初始缓冲大小，建议 4k 或 8k（不能超过 large_client_header_buffers 的单 buffer 大小）
-
large_client_header_buffers 控制后备缓冲区数量和单个上限，例如
4 16k表示最多分配 4 个缓冲区，每个最大 16KB —— 这能容纳实测达 15.8KB 的整行 Cookie - 两者都必须写在
server { }块顶层，不能放在location内，否则会被静默忽略 - Nginx 启动校验（
nginx -t）会检查：client_header_buffer_size ≤ large_client_header_buffers的单 buffer 值；不满足则报错
HTTP/2 场景要额外配置专用参数
如果该 server 启用了 HTTP/2（即 listen 443 ssl http2;），仅调上面两个参数无效，还需补充：
-
http2_max_header_size：控制整个请求头总长度上限，默认 16KB；若实测达 28KB，建议设为
32k -
http2_max_field_size：控制单个字段（如 Authorization 或 Cookie）最大长度，默认 4KB；JWT 类长值需重点调高，例如
12k - 这两个指令只在启用 http2 的 server 块中生效，对 HTTP/1.1 请求无影响
配套防护措施不能少
光扩大缓冲区可能引入风险或掩盖问题，需同步加固：
-
延长读取超时：加
client_header_timeout 120;（默认 60s），防止因缓冲变大、网络慢导致未读完就断连 - 精简源头 Cookie：前端避免把 UI 配置、埋点 ID 等非必要字段塞进 Cookie；后端减少重复 Set-Cookie 或调试头
-
验证真实长度：用
curl -v抓请求头，再执行echo -n "Cookie: ..." | wc -c精确统计字节数（含 CRLF），据此决定参数值
快速验证是否生效
改完配置别只看语法，要闭环验证：
- 加一条带
$request_length的日志格式，观察出错请求的实际请求头总长 - 用 curl 模拟长 Cookie：
curl -H "Cookie: $(printf 'a%.0s' {1..14000})" https://yoursite.com/api - 检查 access.log 是否还有
status=400或status=414；再查 error.log 是否出现 “client sent too large header” 类报错
