首页/开发/软件测试速查/curl 接口调试

curl 接口调试

curl 是接口调试的基本工具:-i 看响应头、-d/-H 构造请求、-w 输出耗时指标、-f 让服务端错误码变成命令失败、-sS 静默但保留错误信息;排查 401 与 429 时常用。

软件测试速查开发更新于 2026-10-12

常用命令

常用命令
curl -sS -i https://api.example.com/v1/users/1

curl -sS -X POST https://api.example.com/v1/users \
  -H 'Content-Type: application/json' \
  -d '{"name":"alice"}'

curl -sS -o /dev/null -w 'code=%{http_code} time=%{time_total}\n' \
  https://api.example.com/healthz
-w 可输出 time_namelookup、time_connect、time_starttransfer 等变量,用于快速分解耗时。

易错点

  • 脚本里不检查退出码(未用 -f 或判断 $?),失败被静默吞掉
  • 命令里直接写真实令牌,随 shell 历史泄露

数据来源与参考

  • curl 官方手册(curl.se/docs/manpage.html)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌