报错排查 · 超时

连接超时:先把「网络」和「服务」分开

超时往往不是 API 挂了。先用 curl 分层测:DNS 能不能解析、TCP 能不能连上、TLS 能不能握手、响应多久返回。

分层诊断

四步定位bash
# 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 很长但能返回服务端排队/冷启动正常,长任务改流式

程序里更容易踩的坑

  • Python 的 requests 会读取环境变量里的代理,HTTP_PROXY 指向失效代理就会一直超时;
  • Docker 容器没配 DNS,宿主机能通、容器不通;
  • Node 的 undici 默认连接超时较短,长任务要显式设置 timeout。

常见问题

超时是平台的问题吗?

先用 curl 分层测:DNS、TCP、TLS 任一阶段失败都是本地网络问题;只有 TTFB 阶段长才是服务端慢。

为什么浏览器能打开网站,程序却超时?

程序可能使用了系统代理或不同的 DNS 解析路径,检查环境变量里的 HTTP_PROXY / HTTPS_PROXY。