用 curl 排查 HTTP 问题:几个最常用的参数和看结果的思路

举报
赛博大妈 发表于 2026/11/17 09:16:12 2026/11/17
【摘要】 curl 是排查接口和网站问题最顺手的工具,本文整理常用参数、耗时拆分和常见返回码的判断思路。

一、先看响应头

排查 HTTP 问题,第一步通常是只看响应头,不下载正文:

curl -I https://目标地址/

-I 发的是 HEAD 请求。个别服务对 HEAD 处理不一样,如果结果可疑,可以用 curl -sS -D - -o /dev/null https://目标地址/,它发 GET 请求,把响应头打印出来,正文丢弃。

二、看完整的通信过程

curl -v https://目标地址/

-v 会输出 DNS 解析后的连接、TLS 握手、请求头和响应头。以 > 开头的是发出的内容,以 < 开头的是收到的内容,以 * 开头的是 curl 自己的提示。证书过期、协议不匹配、重定向循环,大多能在这里看出来。

三、把耗时拆开看

"慢"是最常见的问题,但慢在哪一步要分开看。curl 的 -w 参数可以输出各阶段耗时:

curl -o /dev/null -sS -w 'dns=%{time_namelookup} connect=%{time_connect} tls=%{time_appconnect} ttfb=%{time_starttransfer} total=%{time_total}\n' https://目标地址/

这些时间都是从请求开始累计的:

  • dns 偏大:域名解析慢,查本机 DNS 配置或换解析服务器。
  • connect 减 dns 偏大:网络链路或建立 TCP 连接慢。
  • tls 减 connect 偏大:TLS 握手慢,可能是证书链或加密套件问题。
  • ttfb 减 tls 偏大:服务端处理慢,应该去看后端。
  • total 减 ttfb 偏大:正文传输慢,通常是带宽或内容太大。

这样一拆,就不会把后端慢误判成网络慢。

四、常用的几个开关

  • -L:跟随重定向。不加时看到 301/302 就停了。
  • -k:跳过证书校验。只用于临时判断问题是不是出在证书上,不要写进脚本长期用。
  • --resolve 域名:443:地址:手动指定域名对应的地址,用来在切换前验证新服务器,不用改 hosts。
  • -H 'Header: 值':自定义请求头,比如测试 Host 头或 Authorization。
  • --max-time 10:限制总时长,避免脚本卡死。
  • --retry 3:失败自动重试,适合不稳定的网络。
  • -X POST -d '...':发 POST 请求。注意 -d 默认按表单类型发送,发 JSON 要自己加 -H 'Content-Type: application/json'。

五、返回码怎么读

  • 2xx:成功。
  • 301/302/307/308:重定向,用 -L 跟随,看 Location 头。
  • 400:请求本身有问题,检查参数和请求头。
  • 401/403:认证失败或没有权限,两者含义不同,401 是没认证,403 是认证了但不允许。
  • 404:路径不对,或者反向代理没有转发到正确的后端。
  • 502/503/504:多出现在反向代理后面,通常是后端挂了、过载或响应超时,应去看后端日志。

curl 本身也有退出码,比如 6 表示无法解析域名,7 表示连接失败,28 表示超时,35 往往是 TLS 握手问题。在脚本里用 echo $? 就能拿到。

我的几点看法

  1. 排查先用 -v 看全过程,再用 -w 拆耗时,比凭感觉猜要快得多。
  2. -k 只是诊断手段,用完要把根因(证书)修好。
  3. 区分 401 和 403、区分网络慢和后端慢,能少走很多弯路。
  4. 把常用的 -w 格式存成文件,用 -w @文件名 引用,日常排障更省事。
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。