curl 排障四件套:-v 看细节、-d 带 JSON、-w 测耗时、-L 跟重定向
一、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,这两个习惯能省掉一半的诡异问题。
- 点赞
- 收藏
- 关注作者
评论(0)