HTTP 与 Web 标准 / 系统课时

用 curl 定位接口异常

用 curl 定位接口异常

接口失败时,只看浏览器里的“请求失败”很难判断故障落在 DNS、TCP、TLS、重定向还是服务端处理。curl 可以把一次请求拆成可观察的阶段,并用详细日志、重定向统计和计时指标快速缩小范围,再针对真正异常的那一段继续排查。

学习目标

  • 从 curl -v 输出中区分 DNS、连接、TLS 与 HTTP 阶段
  • 识别重定向链和重定向循环
  • 用 --write-out 的计时变量判断耗时集中在哪个阶段

先把请求拆成可观察阶段

HTTPS 请求大致经历 DNS 解析、TCP 连接、TLS 握手、发送 HTTP 请求、等待首字节和接收响应。curl -v 会把连接信息与请求、响应头打印出来,适合先确认故障发生在 HTTP 之前还是之后。

curl 排查 HTTPS 请求的阶段与观测信号

把占位符换成实际接口地址后执行:

bash
curl -v -o /dev/null 'https://<HOST>/<PATH>'

预期输出

text
* Host <HOST>:443 was resolved.
* IPv4: <IP>
* Connected to <HOST> (<IP>) port 443
* <TLS_HANDSHAKE_INFORMATION>
> <HTTP_REQUEST_LINE_AND_HEADERS>
< HTTP/<VERSION> <STATUS>
< <RESPONSE_HEADERS>

不同 curl 版本、HTTP 版本和 TLS 后端的具体文字可能不同,但输出顺序仍可用来定位阶段。若在出现 HTTP 状态行之前就失败,应优先查 DNS、网络、监听端口或 TLS;已经拿到 4xx、5xx 状态码,则说明请求至少到达了某个 HTTP 服务,应继续检查响应头、响应体以及反向代理或应用日志。

根据失败位置缩小范围

出现 Could not resolve host 时,先检查主机名、DNS 服务器和代理环境变量;能解析但无法建立连接,则检查目标 IP、端口监听、防火墙和网络路径。若 TCP 已连接、TLS 阶段失败,应核对证书是否过期、证书主机名是否覆盖 <HOST>、中间证书链是否完整,以及客户端信任库是否正确。

拿到 HTTP 响应后,再区分应用错误和代理错误。401、403 往往与认证或授权有关;404 可能是路由或代理转发路径错误;502、503、504 常见于反向代理无法正常获得上游结果,但仍应结合代理日志确认根因,不能只凭状态码判断具体故障。

识别重定向循环

-L 会跟随 Location,--max-redirs 可以限制最多跟随次数,再配合 --write-out 输出最终状态、重定向次数和最终 URL。下面把最大次数限制为 5,避免错误配置造成持续跳转。

bash
curl -sS -o /dev/null -L --max-redirs 5 -w 'status=%{response_code}\nredirects=%{num_redirects}\nurl=%{url_effective}\n' 'https://<HOST>/<PATH>'

预期输出

text
status=<STATUS>
redirects=<COUNT>
url=<FINAL_URL>

正常链路的 <COUNT> 应小于等于 5,并停在预期 <FINAL_URL>。如果 curl 因超过最大重定向次数退出,重点检查每一跳的 Location,尤其是 HTTP 与 HTTPS 互跳、带斜杠与不带斜杠互跳,以及代理重写 Host 或路径后又被应用改回的情况。

用计时指标判断慢在哪里

对于“能返回但很慢”的接口,不要只看总耗时。--write-out 可以输出从请求开始累计到各阶段的时间:

bash
curl -sS -o /dev/null -w 'dns=%{time_namelookup}\nconnect=%{time_connect}\ntls=%{time_appconnect}\nttfb=%{time_starttransfer}\ntotal=%{time_total}\n' 'https://<HOST>/<PATH>'

预期输出

text
dns=<TIME>
connect=<TIME>
tls=<TIME>
ttfb=<TIME>
total=<TIME>

这些值是从请求开始累计的时间,不是彼此独立的阶段耗时。对一次新建 HTTPS 连接,可粗略看 connect - dns 判断 TCP 建连开销,tls - connect 判断 TLS 握手开销,ttfb - tls 观察请求发出后等待首字节的时间,total - ttfb 则反映首字节之后的响应传输。若存在重定向、代理或连接复用,必须结合 -v 输出解释,不能机械相减。

修复后用同一请求复测

定位后应保留同样的 URL、方法、请求头和网络出口重新执行原命令,避免“换了测试条件”造成假修复。DNS、连接、TLS、状态码和计时都恢复到合理范围后,再验证接口响应体是否符合业务预期;只有链路层和业务层同时通过,才算真正完成故障闭环。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 curl 定位接口异常

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通