proxy_buffer_size 用于设置 nginx 缓存上游响应头的缓冲区大小，默认 4k，过小会导致 400 错误或“upstream sent too big header”日志；它仅影响响应头，需与 proxy_buffers 等参数协同调优，推荐按需设为 16k 或 32k 并确保不超过单 buffer 大小。
proxy_buffer_size 用于控制 Nginx 代理时缓存上游服务器响应头（response headers）的缓冲区大小。当后端返回的响应头过大（例如含长 Cookie、大量 Set-Cookie、自定义长 Header 或 JWT Token），而该值过小，Nginx 会报错 400 Bad Request 或日志中出现 upstream sent too big header，此时需调优。
为什么 proxy_buffer_size 容易被忽略
它只影响响应头（headers），不控制响应体（body）；而 body 缓冲由 proxy_buffers 和 proxy_buffering 控制。很多人误调大 proxy_buffers 却没改 proxy_buffer_size，问题依旧存在。
默认值通常为 4k（即 4096 字节），对普通网站足够，但微服务、带 OAuth Token 或多跳认证的 API 往往超出此限。
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
如何正确设置 proxy_buffer_size
- 在
location或server块中显式配置，优先级高于 http 块（推荐放在 location 内，按需精细化控制） - 常见安全且兼容的取值：
proxy_buffer_size 16k;或proxy_buffer_size 32k; - 若已知最大响应头长度（如通过 curl -I 或抓包估算），可设为略大于该值（建议向上取整到 4k 倍数，如 8k、12k、16k）
- 注意：该值不能超过单个 buffer 的大小（即
proxy_buffers中每个 buffer 的 size），否则会被自动截断或降级处理
配套必须检查的参数
单独调大 proxy_buffer_size 不够，还需确认以下三项协同生效：
-
proxy_buffers 8 16k;—— 表示共 8 个缓冲区，每个 16k；其中第一个 buffer 专供响应头，其余用于响应体。所以proxy_buffer_size必须 ≤ 16k -
proxy_busy_buffers_size 32k;—— 正在发送中的缓冲区总上限，应 ≥ 单个 buffer size × 2（如 16k × 2 = 32k） -
proxy_max_temp_file_size 1024m;（可选）—— 若启用磁盘缓冲，确保临时文件有足够空间
验证是否生效
修改后重载 Nginx（nginx -s reload），再通过以下方式确认：
- 查看 error.log 是否还有
upstream sent too big header报错 - 用
curl -I http://your-domain/api观察响应头总长度（可用wc -c统计） - 开启
error_log /path/to/error.log debug;（临时）可看到 buffer 分配详情（需编译含 debug 日志支持）
