Nginx 返回400错误主因是client_header_buffer_size默认仅1k，不足以容纳大Cookie；需同步调大client_header_buffer_size（如2k）和large_client_header_buffers（如4 8k）才能可靠支持。
当用户携带超大 Cookie 访问 Nginx 服务时，常会返回 400 Bad Request 错误，典型提示为 "400 Bad Request: The request header or cookie is too large"。根本原因在于 Nginx 默认的请求头缓冲区（client_header_buffer_size）太小（通常仅 1k），无法容纳含长 Cookie 的完整请求行与请求头。
理解 client_header_buffer_size 的作用
该指令定义 Nginx 为每个 HTTP 请求分配的初始请求头缓冲区大小。它用于存储请求行（如 GET /path HTTP/1.1）、请求头字段（包括 Cookie: 行）等。若请求头总长度超过该值，Nginx 会尝试使用更大的 large_client_header_buffers 缓冲区；但如果 Cookie 过长、且未合理配置后者，就会直接拒绝请求并返回 400。
注意：client_header_buffer_size 不是最大限制，而是“第一道缓冲区”。真正决定能否接收大 Cookie 的，是它与 large_client_header_buffers 的组合配置。
关键配置：同时调整两个参数
仅增大 client_header_buffer_size 通常不够。必须配合 large_client_header_buffers 才能可靠支持大 Cookie（例如含 JWT Token 或多域跟踪信息的场景）：
-
估算 Cookie 大小：用浏览器开发者工具查看实际请求的
Cookie字段长度（单位：字节）。常见超大 Cookie 多在 2KB–8KB 区间。 -
设置初始缓冲区：将
client_header_buffer_size设为略大于平均 Cookie 长度（如2k或4k）。 -
配置备用缓冲区：用
large_client_header_buffers指定更大容量和数量，例如：large_client_header_buffers 4 8k;表示最多分配 4 个、每个 8KB 的缓冲区，总可用达 32KB。
示例配置（放在 http 或 server 块中）：
large_client_header_buffers 4 8k;
验证与调试方法
修改后需重载 Nginx 并观察效果：
- 用
curl -v -H "Cookie: key=value..." http://your-site/模拟大 Cookie 请求，检查响应状态码。 - 开启 Nginx 错误日志（
error_log /path/to/error.log debug;），查找类似client sent too large header或too large cookie的记录。 - 确认客户端是否真的发送了超长 Cookie（如第三方 SDK 注入、跨域共享 Cookie 等），必要时从源头优化 Cookie 内容（如缩短 domain、减少冗余字段、改用 token 存储在请求体或 header 中）。
其他相关注意事项
除缓冲区外，还需排查以下常见干扰项：
- client_max_body_size：仅影响请求体（POST 数据），与 Cookie 无关，无需调整。
-
underscores_in_headers on;：若 Cookie 名含下划线（如
auth_token），默认被拒绝；启用该指令可允许，但非解决 400 的主因。 - HTTP/2 影响：在 HTTP/2 下，头部压缩（HPACK）会降低传输体积，但 Nginx 解压后的内存缓冲仍受上述参数限制，配置逻辑不变。
-
安全权衡：过度放宽缓冲区可能增加内存消耗或遭受头部膨胀攻击，建议按实际业务需求设定上限（如不超过 16KB），避免设为
large_client_header_buffers 16 64k这类过大值。
