proxy_buffer_size是nginx专用于缓存响应头的独立缓冲区，仅在proxy_buffering on时生效，设小导致502错误，设大浪费内存；需实测响应头大小（含\r\n）后向上取整至最近2的幂次设置，且必须小于proxy_buffers单块大小，并同步检查http/2下的http2_max_field_size。
proxy_buffer_size 是 Nginx 专用于缓存响应头（status line + headers）的独立缓冲区，不是调 TCP 或响应体的参数。它只在 proxy_buffering on 时生效，设小了会直接返回 502 Bad Gateway，设大了则浪费内存——尤其在万级并发下，每请求独占该内存。
实测最大响应头大小再设值
别猜，必须基于真实数据：
- 用
curl -v https://your-api/ 2>&1 | grep '^ 抓原始响应头，手动统计所有字符 + 每行末尾的 <code>\r\n（各占 1 字节） - 或临时开启 debug 日志：
error_log /var/log/nginx/error.log debug;，复现请求后日志中会出现类似header: 13782 bytes的明确提示 - 实测值为 12345 字节 → 推荐设
proxy_buffer_size 16k（向上取整到最近 2 的幂次）；实测 28900 字节 → 设32k
必须满足硬性大小约束
这个值不能孤立配置：
- 必须小于
proxy_buffers的单块大小（例如proxy_buffers 8 128k，则proxy_buffer_size最大只能设128k，但通常16k就够） - 若设得比单 buffer 还大，Nginx 启动直接报错：
upstream sent too big header，并拒绝加载配置 - 它和
proxy_buffers、proxy_busy_buffers_size职责分离：前者只管 header，后两者只管 body
确认 proxy_buffering 是否开启
这个参数仅在 proxy_buffering on 时起作用：
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
- SSR 页面、REST API 等常规场景建议保持开启，这是启用 header 缓冲的前提
- SSE、gRPC-Web、LLM 流式响应等场景若设为
off，proxy_buffer_size完全被忽略，Nginx 直接透传 header - 务必在
location块中显式声明proxy_buffering on;，避免被上级配置覆盖
HTTP/2 下需同步检查 http2_max_field_size
HTTP/2 使用 HPACK 压缩，字段解码后长度受独立限制：
-
http2_max_field_size默认仅 4k，若单个 header 字段（如超长Set-Cookie或Authorization）解码后超出，同样触发 502 - 该值需与
proxy_buffer_size协同调整，例如设proxy_buffer_size 16k时，建议同步设http2_max_field_size 16k - 注意：它影响的是 HPACK 解码后的字段长度，不是 wire 上的原始字节数
优先从源头精简响应头
调大缓冲只是兜底手段，不是长期解法：
- 排查后端是否注入重复
Set-Cookie、未清理的调试头（如X-Debug-Info、X-Powered-By） - 检查网关或中间件是否层层叠加
X-Request-ID、X-Trace-ID等冗余字段 - JWT 放 header 没问题，但避免同时在 Cookie 和 header 中重复携带
- 若 header 持续膨胀，应先优化后端逻辑，而不是无限制扩大 buffer
不复杂但容易忽略
