Nginx HTTP代理超时控制通过设定连接建立、请求发送、响应读取三阶段时限主动断连，防资源堆积；核心是配置proxy_connect_timeout、proxy_send_timeout、proxy_read_timeout等参数，分别对应502/504错误，配合client_*系列参数防408及慢速攻击，并支持location级精细化覆盖。
Nginx 中 HTTP 代理的请求超时中断，本质是通过控制连接建立、请求发送、响应读取三个关键阶段的时限，让 Nginx 主动断开异常或过长的请求，避免资源堆积和假死。配置的核心不是“中断”本身，而是设定明确的超时阈值，超时即终止当前代理流程并返回标准错误（如 502/504）。
以下按实际作用对象分三类说明，直接可用：
一、后端通信超时（最关键，防 504）
这些参数决定 Nginx 和你后端服务（如 Python/Java/Node 应用）之间的交互时限，必须放在 http 或 location 块中：
proxy_connect_timeout：Nginx 尝试与后端建立 TCP 连接的最大时间
→ 超时返回 502 Bad Gateway
→ 建议值：内网 3–5s，跨机房或云环境 10sproxy_send_timeout：Nginx 向后端发完全部请求（头+体）的最长时间
→ 超时返回 504 Gateway Timeout
→ 建议值：普通接口 30s；含大 Body 的上传接口可设 60–120sproxy_read_timeout：Nginx 等待后端返回响应的最长时间（从发完请求开始计）
→ 超时返回 504 Gateway Timeout
→ 建议值：常规 API 60s；导出、长轮询等场景设为 300–3600s
示例（全局统一）：
http {
proxy_connect_timeout 10s;
proxy_send_timeout 60s;
proxy_read_timeout 300s;
server {
location / {
proxy_pass http://backend;
}
}
}二、客户端连接超时（防 408，防慢速攻击）
控制浏览器或客户端到 Nginx 这一段的行为，避免空闲连接长期占用 worker：
client_header_timeout：等待客户端发完请求行和所有 Header 的最大时间
→ 超时返回 408 Request Timeout
→ 建议值：10–20s（移动端或带 JWT 头可设 15s）client_body_timeout：接收 POST/PUT 数据时，两次数据包间隔上限（非总上传时长）
→ 超时返回 408
→ 建议值：文件上传设 120s，普通表单 15–30ssend_timeout：Nginx 向客户端发响应时，两次 write 操作间隔上限
→ 超时直接断连（可能返回不完整响应）
→ 建议值：10–30s（跨境或弱网链路可放宽至 60s）
三、按路径精细化覆盖（不破坏全局，只改必要项）
特殊接口需单独调宽或收严，只需在对应 location 中重写相关参数：
-
上传接口（如
/upload）：location /upload { proxy_read_timeout 600s; client_body_timeout 600s; client_max_body_size 100m; proxy_pass http://backend; } -
健康检查（如
/healthz）：location /healthz { proxy_read_timeout 2s; proxy_connect_timeout 1s; proxy_send_timeout 1s; proxy_pass http://backend; } -
WebSocket/SSE（需升级协议）：
location /ws { proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; proxy_read_timeout 3600; # 长连接保持 proxy_pass http://backend; }
改完务必执行：
nginx -t && nginx -s reload
并观察 error.log 中是否出现 upstream timed out 日志，确认生效。不复杂但容易忽略。
