为特定耗时接口单独配置Nginx代理超时，需在匹配路径的location块内设置proxy_connect_timeout、proxy_send_timeout、proxy_read_timeout三项参数，并同步关闭proxy_buffering、启用HTTP/1.1连接复用，且后端超时须≥proxy_read_timeout。
为特定耗时接口（如报表导出、AI推理、批量任务）单独配置 Nginx 代理超时，核心是在匹配该路径的 location 块内精准设置三项 proxy 超时参数，不改动全局配置，避免影响其他接口稳定性。
定位并进入正确的 location 块
必须确保配置写在真实处理该请求的 location 中。例如：
- location /api/v1/export/ { ... }
- location ~ ^/report/.+\.pdf$ { ... }
用 nginx -T | grep -A5 "export" 验证配置是否生效在预期位置。在 http 或 server 级别设置不会对特定路径起作用。
只在此 location 内设置三项关键超时
在上述 location 块内部直接添加以下指令（单位支持 s 或 m）：
- proxy_connect_timeout：设为 10s～30s；若后端冷启动慢（如 Spring Boot 首次加载需 90s），则需 ≥120s，否则直接报 502
- proxy_send_timeout：设为 300s（5 分钟）或更高；适用于大文件上传、含大量参数的 POST 请求
- proxy_read_timeout：最关键；按业务 P95 耗时 ×1.2 向上取整，例如导出接口 P95 是 480s，建议设为 600s 或 10m；超时返回 504
配套必须同步调整的项
仅调超时不足够，链路中任一环节提前中断都会导致失败：
- proxy_buffering off;：尤其对流式导出、SSE 场景，防止 Nginx 缓存未完成响应
- proxy_http_version 1.1; + proxy_set_header Connection '';：启用 HTTP/1.1 连接复用
- 若使用 upstream，建议加 keepalive 32; 和 least_conn;，防长请求占满单台后端
- 后端服务（如 Tomcat、Gunicorn）的连接超时（如
connection-timeout）必须 ≥proxy_read_timeout，否则它先断连，Nginx 还没到超时就收不到响应
验证配置是否生效
修改后务必执行两步：
-
nginx -t检查语法正确性 -
nginx -s reload平滑重载 - 用
curl -v http://your-domain/api/v1/export/big观察是否在预期时间后返回 504，或成功完成长响应
