proxy_read_timeout仅控制nginx收到响应头后等待响应体数据到达的最大空闲时长，超时即断连返回504；需按路径用location隔离配置，同步调大proxy_send_timeout、send_timeout及upstream keepalive，并确保后端超时设为该值的0.8倍。

proxy_read_timeout 不是用来“延长整体请求时间”的开关，它只管一件事：Nginx 收到后端响应头（比如 HTTP/1.1 200 OK 和所有 headers）之后，等待第一个字节响应体、以及后续数据块之间的**最大空闲时间**。超时即断连，返回 504。

按路径单独配置，别全局改

后端若同时跑登录接口和报表导出，不能所有请求都用同一个 timeout。必须用 location 隔离长响应路径：

• 普通 API（如 /api/user、/health）：保持 proxy_read_timeout 20; 或默认值，快速失败利于前端降级
• 明确长响应路径（如 /api/export、/downloads/.*\.(pdf|zip)）：在对应 location 块中显式设置更高值
• 数值参考真实监控：取该路径近 7 天 P95 或 P99 耗时 × 1.2～1.5。例如 P99 是 240 秒 → 设为 300 秒较稳妥

三个参数必须同步调大

只改 proxy_read_timeout 很可能白忙——连接可能在其他环节就被切断了：

FastAPI Flask Proxy

FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。

下载

• proxy_send_timeout ≥ proxy_read_timeout：确保 Nginx 有足够时间把大请求体（如带 token 的导出参数、XML 文件）完整发给后端
• send_timeout ≥ proxy_read_timeout：防止用户网络差、下载慢，Nginx 在转发响应体时提前关掉客户端连接
• upstream 块启用连接复用：keepalive 32;，并配 proxy_http_version 1.1; 和 proxy_set_header Connection '';，避免每次重连消耗资源

后端超时必须比 Nginx 小

如果后端（如 Tomcat、Gunicorn、Spring Boot）自身超时设得比 Nginx 还长，会出现“后端已静默断连，Nginx 还在等”，最终报 502 或 504：

• 推荐后端超时 = Nginx proxy_read_timeout × 0.8 左右（例如 Nginx 设 300 秒，后端设 240 秒）
• 检查框架配置：Spring Boot 的 server.tomcat.connection-timeout、Flask 的 timeout、Gunicorn 的 --timeout
• 后端不要提前 WriteHeader 或 flush 空响应；应等真正有数据或确定超时时，再一次性写出 header + body

验证是否真生效

改完不验证等于没改：

• 打开 Nginx error 日志：error_log /var/log/nginx/error.log notice;，搜索 upstream timed out 或 readv() failed
• 用 curl -v 测试长路径，观察实际耗时与状态码是否符合预期
• 检查上游云负载均衡器（如 AWS ALB 默认 60 秒、阿里云 SLB 默认 60 秒）——它的 idle timeout 可能比 Nginx 更早切断连接