Nginx 代理超时怎么配置 proxy_read_timeout 读取超时-Nginx-PHP中文网

proxy_read_timeout仅控制nginx收到响应头后等待响应体数据到达的最大空闲时长，超时即断连返回504；它不管连接建立、请求发送或客户端传输，须按路径隔离配置，并同步调大proxy_send_timeout、send_timeout及upstream keepalive。

nginx 代理超时怎么配置 proxy_read_timeout 读取超时

proxy_read_timeout 不是延长整个请求时间的“总开关”，它只管一件事：Nginx 收到后端响应头（比如 HTTP/1.1 200 OK）之后，等待响应体数据到达的最大空闲时长。超了就断连，返回 504。

它到底控制哪一段？

✅ 控制：后端已发完响应头，Nginx 等待第一个字节响应体、或后续数据块之间的静默时间（例如导出 Excel 流、AI 推理结果、SSE 数据帧）
❌ 不管：
- TCP 连接建立（那是 proxy_connect_timeout）
- Nginx 把请求发给后端（那是 proxy_send_timeout）
- Nginx 把响应传给客户端（那是 send_timeout）
- OPTIONS 预检、WebSocket 握手、客户端上传过程

日志里出现 upstream timed out (110: Connection timed out)，没写明 connect 还是 read —— 实际八成是 proxy_read_timeout 触发的。

怎么设一个合理值？按路径隔离，别全局一刀切

后端同时跑登录接口和报表导出，不能全用一个值。

普通 API（如 /api/user、/health）：设 proxy_read_timeout 20;
（P99 通常 1–3 秒，留 5 倍余量够用，快速失败利于前端降级）
明确长耗时路径（如 /api/export/、/downloads/.*\.(pdf|zip)）：单独写 location 块
参考该路径近 7 天 P95 或 P99 × 1.2～1.5：
- 若导出 P99 是 285 秒 → 设 360（6 分钟）
- 若波动大（30 秒～10 分钟）→ 宁可略高，但避免填 86400

示例配置：

location ^~/api/export/ {
    proxy_pass http://backend;
    proxy_read_timeout 360;
    proxy_send_timeout 360;
    send_timeout 360;
    proxy_buffering off;
    proxy_http_version 1.1;
    proxy_set_header Connection '';
}

必须同步调大的三个参数

只改 proxy_read_timeout 就像加固门却忘了关窗：

proxy_send_timeout ≥ proxy_read_timeout
防止大请求体（如带 token 的导出参数、XML 文件）还没发完，Nginx 就先切断连接
send_timeout ≥ proxy_read_timeout
确保弱网用户下载导出文件时，Nginx 不会中途断开客户端连接
upstream 块启用连接复用：

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

下载
```
upstream backend {
    server 10.0.1.10:8080;
    keepalive 32;
}
```
并在对应 location 中配 proxy_http_version 1.1; 和 proxy_set_header Connection '';

后端超时必须比 Nginx 小

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

推荐后端超时 = proxy_read_timeout × 0.8
例如 Nginx 设 360 秒，后端设 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 更早切断连接