超时往往不是 API 挂了。先用 curl 分层测:DNS 能不能解析、TCP 能不能连上、TLS 能不能握手、响应多久返回。
# 1) DNS nslookup hardysapi.com # 2) 连通性 + TLS + 首字节(-w 打印各阶段耗时) curl -o /dev/null -s -w "dns=%{time_namelookup} tcp=%{time_connect} tls=%{time_appconnect} ttfb=%{time_starttransfer} total=%{time_total}\n" \ https://hardysapi.com/health # 3) 换直连域名排除 CDN curl -o /dev/null -s -w "%{http_code} %{time_total}\n" https://api.hardysapi.com/health # 4) 强制 IPv4(部分环境 IPv6 不通) curl -4 -o /dev/null -s -w "%{http_code} %{time_total}\n" https://hardysapi.com/health
| 现象 | 多半是 | 处理 |
|---|---|---|
| dns 阶段就卡住 | 本地 DNS 污染/故障 | 换 DNS,或用直连域名 |
| tcp 连不上 | 防火墙/代理/网络出口 | 检查系统代理与公司网络 |
| tls 阶段失败 | 中间人代理、系统时间错误 | 关掉 SSL 拦截,校准时间 |
| ttfb 很长但能返回 | 服务端排队/冷启动 | 正常,长任务改流式 |
requests 会读取环境变量里的代理,HTTP_PROXY 指向失效代理就会一直超时;undici 默认连接超时较短,长任务要显式设置 timeout。先用 curl 分层测:DNS、TCP、TLS 任一阶段失败都是本地网络问题;只有 TTFB 阶段长才是服务端慢。
程序可能使用了系统代理或不同的 DNS 解析路径,检查环境变量里的 HTTP_PROXY / HTTPS_PROXY。