直接调大 proxy_buffer_size 是解决响应头过大导致 502 或 400 的最有效方式，但须基于实测值设置，并与 proxy_buffers、proxy_busy_buffers_size 协同配置；先查错误日志确认是否真超限，再用 curl -v 验证响应头大小。
直接调大 proxy_buffer_size 是解决响应头过大导致 502 或 400 的最有效方式，但必须基于实测值设置，并与 proxy_buffers 和 proxy_busy_buffers_size 协同配置，否则容易无效或引发新问题。
先确认是不是响应头真超限
别凭经验改配置，先看证据：
- 查 Nginx 错误日志（如 /var/log/nginx/error.log），找这行：upstream sent too big header while reading response header from upstream
- 用 curl -v http://your-api/ 2>&1 | grep '^ 统计实际响应头总字节数（含每行末尾的
\r\n） - 若结果明显超过 4096 字节（即 4k），基本可锁定问题
合理设置 proxy_buffer_size
这个参数只管响应头，不处理响应体。设得太小会报错，太大则浪费内存甚至带来安全风险：
- 默认值通常是 4k（部分系统为 8k），对含 JWT、多段 Cookie、调试头的接口普遍不足
- 根据实测值略作冗余：比如测出最大为 12345 字节，推荐设为 16k（向上取最接近的 2 的幂次）
- 常见稳妥值：16k 或 32k；高频出错可试 64k；不建议设成 1m 等极大值
- 必须放在 location 块内，且位于 proxy_pass 指令之前
必须同步调整关联缓冲参数
单独改 proxy_buffer_size 很难生效，它和另外两个参数是协作关系：
- proxy_buffers 8 16k;：分配 8 个缓冲区，每个 16KB，用于响应体；其中第一个 buffer 专供响应头，所以 proxy_buffer_size 必须 ≤ 单个 proxy_buffer 大小
- proxy_busy_buffers_size 32k;：控制边收边发时最多可用的缓冲总量；建议设为单个 proxy_buffer 大小的 2 倍（如 16k × 2 = 32k）
- 若启用 HTTP/2，还需检查 http2_max_field_size（默认 4k），它独立限制 HPACK 解码后的单字段长度
优先从后端精简响应头
调大缓冲只是临时缓解，长期应优化源头：
- 排查重复 Set-Cookie（如登录后连续下发多个 JWT）
- 移除非必要调试头：X-Trace-ID、X-Debug-Info、X-Powered-By
- 避免把长 Token 直接塞进响应头，改用短 ID + 后端查表方式
- 检查是否因循环重定向或认证逻辑缺陷导致 Header 指数级膨胀
