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