proxy_connect_timeout 应设为真实建连p95值的1.5～2倍（如1.3s→2s～3s），内网3s～5s、回环1s～1.5s、跨地域500ms～1.5s，须置于location/server块，配proxy_next_upstream等三件套并实测验证。
调 proxy_connect_timeout 不是为了“延长等待”，而是让 Nginx 更快、更准地判断后端连不上——把无效卡顿砍掉，把故障暴露出来。它只管 TCP 三次握手阶段（发 SYN 后等 SYN-ACK），不涉及 DNS、TLS、后端处理慢或数据传输卡住。
先测真实建连耗时，再定值
别用默认 60 秒，也别凭感觉设 1 秒。在 Nginx 所在机器执行：
for i in {1..30}; do curl -w "%{time_connect}\n" -o /dev/null -s http://backend:port/health; done | sort -n- 取结果中 P95 值 × 1.5～2，作为建议值（例如 P95 是 1.3s → 设为 2s～3s）
- 内网同机房：通常 3s～5s 合理；本地回环或容器直连：1s～1.5s 即可；跨地域：500ms～1.5s
放对位置，单位写准
这个参数必须出现在启用 proxy_pass 的上下文中：
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
- ✅ 推荐放在
location或server块里（支持按路径精细化控制） - ✅ 全局默认可设在
http块，但不建议一刀切 - ❌ 不能写在
upstream块里，Nginx 不识别 - 单位要明确：写
3s或800ms都行，但别写3000（无单位会静默忽略）
单设没用，必须配齐三件套
只改超时，只会更快报错，不会自动绕开故障节点。要实现“快失败 + 快切换 + 快隔离”，得一起配：
- 启用重试：
proxy_next_upstream error timeout - 限制次数防雪崩：
proxy_next_upstream_tries 2 - 上游加健康检查：间隔设为超时值的 1.5～2 倍（如超时 3s → 检查间隔 6～10s），
max_fails=2 fail_timeout=30s
验证它真在起作用
配置写完不是终点，三步实测确认：
- 临时停一个后端服务，用
curl -v测客户端收到 502 的延迟，应接近你设的值（±300ms 内） - 开启 debug 日志：
error_log /var/log/nginx/error.log debug;，搜索connection timed out while connecting to upstream - 用
tcpdump抓包：若 SYN 发出后未收 SYN-ACK 就断开，说明确实是 connect 阶段超时
