curl 排障四件套:-v 看细节、-d 带 JSON、-w 测耗时、-L 跟重定向

举报
yd_273693568 发表于 2026/11/10 00:21:40 2026/11/10
【摘要】 一、curl 是排障的第一把扳手服务异常时,很多人第一反应是翻日志——但日志只能看到服务自己「认为」发生了什么。curl 能让你从客户端视角亲眼看一遍请求,配合几个参数,一次调用就把方法、头、状态码、耗时全部拿到。这篇讲最常用的几个参数组合,背下来就能应付九成场景。二、-v:一条命令看到全部细节curl -v https://api.example.com/health-v(verbose)...

一、curl 是排障的第一把扳手

服务异常时,很多人第一反应是翻日志——但日志只能看到服务自己「认为」发生了什么。curl 能让你从客户端视角亲眼看一遍请求,配合几个参数,一次调用就把方法、头、状态码、耗时全部拿到。这篇讲最常用的几个参数组合,背下来就能应付九成场景。

二、-v:一条命令看到全部细节

curl -v https://api.example.com/health

-v(verbose)是最重要的参数,没有之一。输出分两类行:> 开头是你发出去的请求(方法、路径、头),< 开头是服务端回来的响应(状态码、响应头),中间是连接建立过程(TCP、TLS 握手耗时)。看到 < HTTP/1.1 502 就知道问题在服务端或网关;看到 TLS 握手失败就知道问题在证书或网络。

嫌输出太多可以用 -s -o /dev/null -w "%{http_code}" 只拿状态码——写监控脚本时这组合是标配。

三、-H / -d / -X:把请求说清楚

curl -v -X POST https://api.example.com/orders \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"item":"book","qty":1}'

-H 加请求头(可重复),-d 带请求体(用了 -d 默认就是 POST),-X 显式指定方法(GET/PUT/DELETE)。新手最容易犯的错:发 JSON 忘了 Content-Type,服务端按表单解析,参数全丢——报错还看不出来在哪。记住:**带 -d 就顺手带上 Content-Type**。

四、-L 跟随重定向,-k 跳过证书校验

-L 让 curl 跟着 301/302 走,遇到「浏览器能开、curl 报 302」的场景,加 -L 就通了。想看重定向链条,用 -sIL 只看响应头,每一跳的状态码和 Location 一目了然。

-k 跳过证书校验,只用于本机自签证书的临时调试。生产环境永远不要带 -k——它会把你真正需要发现的证书过期、域名不匹配问题全部吞掉。

五、-w:把耗时数字拿到手

curl -s -o /dev/null -w "dns=%{time_namelookup} connect=%{time_connect} tls=%{time_appconnect} total=%{time_total}\n" https://api.example.com

这条命令把请求拆成四段耗时:DNS 解析、TCP 连接、TLS 握手、总耗时。哪一段异常大,问题就在哪一段——dns 大是解析慢(回看上一篇 dig),tls 大是握手慢(证书链长或网络抖动),都正常但 total 大就是服务端处理慢。

六、下载文件:-o、-O 与断点续传

-o 文件名 把响应存成指定文件(-o /dev/null 就是丢弃输出只看过程);-O 用 URL 里的原名保存。下载大文件中途断了,加 -C - 从断点继续:curl -C - -O https://example.com/big.iso,配合 --limit-rate 2m 还能限速,避免占满带宽。

排障时想保留完整响应体又不想刷屏,-s -o resp.json -w "%{http_code}" 一条命令:状态码上屏、正文落盘,之后随便你用 jq 怎么翻。

七、三个高频坑

  • -d 里的引号被 shell 吃掉。JSON 里的双引号要转义或用单引号包整体;复杂 JSON 建议写成文件用 -d @data.json。
  • URL 带 & 没加引号。shell 会把 & 当后台运行符,请求被截断,URL 永远用引号包起来。
  • HTTPS 报证书错误先看时间。机器时间不对会让合法证书被判过期,date 先确认系统时间再怀疑证书。

八、三行口诀

排障先 -v 看全貌;发 JSON 记得 Content-Type;分段计时用 -w。URL 加引号、生产不带 -k,这两个习惯能省掉一半的诡异问题。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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