核心思路是精细化配置 proxy_buffering 而非禁用，需区分后端慢、客户端慢或响应体大三类瓶颈，结合 error 日志分析，调优 buffer 参数、超时设置及路径级隔离。
核心思路不是“禁用 proxy_buffering”，而是通过精细化配置让它适配后端响应节奏，避免缓冲积压引发 502/504 或连接重置。
识别真实瓶颈：先分清是响应慢还是客户端慢
缓冲区溢出常被误判为后端问题，实际可能源于三类场景：
- 后端处理确实慢（如数据库查询未优化、同步调用外部 API 卡顿）
- 后端响应快，但客户端网络差或读取速率低（如移动端弱网、浏览器解析慢）
- 后端返回大响应体（如导出 50MB JSON、生成报表），而 Nginx 缓冲区默认值太小
查 Nginx error 日志是关键：出现 upstream sent too big header 是响应头超限；client intended to send too large body 多与客户端上传有关；upstream timed out 则需结合 proxy_read_timeout 分析。
调整 proxy_buffer 系列参数匹配业务特征
保持 proxy_buffering on（推荐），再按需调优以下参数：
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
- proxy_buffer_size 8k：专存响应头。若后端带大量 Cookie、自定义 Header 或 JWT Token，4k 不够，升至 8k 或 16k
- proxy_buffers 16 8k：控制响应体内存缓冲总量（此处为 128KB）。导出类接口可设为 32 16k（512KB），避免过早写入磁盘
- proxy_busy_buffers_size 16k：定义“正在发送中”缓冲区上限，应 ≤ proxy_buffers 总量且 ≥ proxy_buffer_size
- proxy_max_temp_file_size 2048m：允许响应体超出内存后写临时文件。不建议设为 0（禁用磁盘缓冲），否则大响应直接失败
协同设置超时参数，防止缓冲长期挂起
缓冲区积压往往和超时联动发生。不能只调大缓冲，还要让 Nginx 主动释放卡住的连接：
- proxy_read_timeout 120：后端两次发包间隔超时。对流式接口或报表生成，设为 300 更稳妥
- proxy_send_timeout 90：Nginx 向客户端发送数据时，两次 write 间隔超时。弱网环境可设为 180
- proxy_connect_timeout 10：建立到后端连接的等待上限，防阻塞 worker 进程
注意：这些 timeout 是“空闲间隔”，不是整个响应耗时。即使响应总长 5 分钟，只要中间不断流，就不会触发。
针对特殊场景做路径级隔离
不必全局妥协。对明确需要实时性的路径（如 SSE、WebSocket 升级请求、日志推送），单独关闭缓冲：
- 在对应 location 块中加 proxy_buffering off
- 配套设置 proxy_read_timeout 3600、add_header X-Accel-Buffering no
- 禁用 gzip 和 chunked_transfer_encoding，避免额外延迟
其余常规接口仍保持 buffering on，兼顾稳定性与可控性。
