在 nginx 中设置代理超时时间，需要在配置文件中使用 proxy_read_timeout 指令，并指定具体的秒数。该指令定义了 nginx 等待上游服务器响应的时间，默认值为 60 秒。若需调整此值，只需在 location 或 http 上下文中添加该指令即可生效。
proxy_read_timeout 与 proxy_connect_timeout 的区别是什么
这两个指令分别控制连接建立阶段和响应读取阶段的超时行为。proxy_connect_timeout 限制 Nginx 与上游服务器建立 TCP 连接的时间，而 proxy_read_timeout 限制在连接成功后，Nginx 等待上游服务器发送完整响应体的时间。两者配合使用可全面覆盖代理通信的生命周期。
server {
listen 80;
server_name example.com;
location /api/ {
proxy_pass http://backend_server;
proxy_connect_timeout 5s;
proxy_read_timeout 30s;
}
}
上述配置中，proxy_connect_timeout 设为 5 秒，proxy_read_timeout 设为 30 秒。当请求进入 /api/ 路径时，Nginx 将先尝试在 5 秒内完成与后端的连接，若成功则开始等待后端返回数据，最长等待时间为 30 秒。若超过该时间仍未收到响应，Nginx 将返回 504 Gateway Timeout 错误。
如果只设置 proxy_read_timeout 而不设置 proxy_connect_timeout 会怎样
若仅设置 proxy_read_timeout 而未显式配置 proxy_connect_timeout，后者将使用 Nginx 的默认值 60 秒。这意味着连接建立阶段可能比响应读取阶段更耗时，导致整体延迟由连接阶段主导。这种不对称设置适用于后端连接稳定但响应较慢的场景，但需注意避免连接超时掩盖真正的性能瓶颈。
server {
listen 80;
server_name example.com;
location /slow-api/ {
proxy_pass http://backend_server;
proxy_read_timeout 120s;
}
}
在此配置中，proxy_read_timeout 被设为 120 秒，以应对慢速 API 响应。由于未指定 proxy_connect_timeout，其保持默认 60 秒。若后端连接正常，客户端最多等待 120 秒获取响应；若连接失败，则在 60 秒后报错。这种设置适合已知后端响应缓慢但连接可靠的场景，开发者可根据实际监控数据进一步调优两个参数的比例。
