proxy_connect_timeout 控制 nginx 主动建连等待 syn-ack 的最长时间，仅作用于 proxy_pass 上下文（推荐 location 块），单位支持 s/ms，需结合重试、健康检查等机制才能实现可靠故障切换。

proxy_connect_timeout 控制的是 Nginx 主动发起 TCP 连接、等待后端返回 SYN-ACK 的最长时间，只管“拨号是否接通”，不等后端处理、不参与 SSL 握手、也不影响数据传输。它直接决定建连失败后能否快速触发自动切换。

配置位置必须准确
这个参数只能放在启用 proxy_pass 的上下文中：

• 推荐写在 location 块里，按业务路径精细化控制
• 也可在 server 或 http 块中设为默认值，但 location 级别优先级更高
• 放在 upstream 块里完全无效
• 对 fastcgi_pass、uwsgi_pass 等协议不起作用，需改用对应指令（如 fastcgi_connect_timeout）

数值设定要基于实测，不是拍脑袋
默认 60 秒在生产环境明显过长，会导致故障感知延迟和 worker 阻塞：

• 同机房 / 同 VPC 内：实测 P95 ≤1.2s、峰值 4.8s → 建议设为 5–10s（峰值 ×1.5～2）
• 跨可用区或混合云：网络抖动明显 → 设为 8–15s，上限不建议超 30s
• 本地回环（127.0.0.1）或容器直连：通常 1–3s 足够，设为 1.5s 更稳妥
• 单位支持秒（s）和毫秒（ms），例如 proxy_connect_timeout 3s 或 proxy_connect_timeout 800ms；写成 60000（无单位）会被静默忽略

单设它没用，必须联动其他机制
仅调这个参数无法实现可靠故障切换：

• 开启重试：proxy_next_upstream error timeout，让建连失败时尝试下一个节点
• 限制重试次数：proxy_next_upstream_tries 2，防雪崩
• 主动健康检查间隔应略大于该值（如 timeout=5s → check interval=10s）
• 配合 max_fails=2 fail_timeout=30s，平衡敏感性与抗抖动能力

验证是否真生效，别只看配置没报错

FastAPI Flask Proxy

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

下载

• 临时停掉一个后端服务，用 curl -v 观察客户端收到 502 的延迟是否接近你设的值
• 开启 error_log /var/log/nginx/error.log debug，搜索 connect() failed 或 Connection timed out while connecting to upstream
• 用 curl -w "%{time_connect}\n" -o /dev/null -s http://backend-ip:port/health 连续测 30 次，取 P99 和峰值作为设值依据

不复杂但容易忽略