curl get参数失效主因是shell特殊字符未转义,需单引号包裹url并url编码;post json需显式设content-type、单引号包数据、加-x post;超时和ssl问题要区分网络与证书原因;取状态码用-w,调试用-v或-d -。

curl 发送 GET 请求时参数没生效?检查 URL 编码和 shell 特殊字符
最常见的情况是带 ?key=value&foo=bar 的 URL 被 shell 当成命令分隔或通配符处理,比如 & 启动后台进程、* 被展开、空格导致参数截断。
- 用单引号包裹整个 URL:
curl 'https://api.example.com/v1/users?id=123&status=active',避免 shell 解析 - 如果值里含空格或中文,必须 URL 编码:
curl 'https://httpbin.org/get?name=%E5%BC%A0%E4%B8%89',别依赖 curl 自动编码 - 不要写成
curl https://...?a=1&b=2(没引号)——&会让 shell 把b=2当作后台命令执行
POST 提交 JSON 数据总被服务端报 400?重点看 Content-Type 和数据格式
curl 默认不设 Content-Type,服务端收不到正确 MIME 类型,或 JSON 字符串本身有语法错误,都会直接拒收。
- 必须显式加
-H "Content-Type: application/json" - JSON 数据用单引号包裹,避免双引号被 shell 吞掉:
-d '{"name":"alice","age":30}' - 如果 JSON 来自变量,用
jq生成并确保合法:-d "$(jq -n --arg n "bob" '{name:$n, active:true}')" - 别漏掉
-X POST——某些老版本 curl 在用-d时不自动切为 POST 方法
curl 连接超时或 SSL 验证失败?先区分是网络问题还是证书配置问题
curl: (7) Failed to connect 是 DNS 或防火墙问题;(60) SSL certificate problem 则是证书链或系统 CA 不全。
- 快速判断是否 DNS 问题:
curl -v https://example.com看输出里有没有* Trying 93.184.216.34:443... - 跳过证书验证仅限测试:
curl -k https://self-signed.local,但生产环境绝不能用-k - 指定 CA 路径更安全:
curl --cacert /path/to/ca-bundle.crt https://internal-api - 超时控制用
--connect-timeout 5 --max-time 15,前者管建连,后者管整个请求生命周期
需要保存响应头或只取状态码?别用重定向或管道糊弄
用 curl -I 只拿 header 会发 HEAD 请求,有些 API 不支持;用 | head -1 又可能截断多行状态行。真要精确提取,得靠原生选项。
- 获取状态码(不触发 body 下载):
curl -s -o /dev/null -w "%{http_code}" https://httpbin.org/status/201 - 同时保存 body 到文件 + 输出状态码:
curl -w "\nHTTP %{http_code}\n" -o response.json https://api.example.com/data - 调试时加
-v看完整交互,但注意它会把 header 和 body 混在 stdout,不适合脚本解析 - 想过滤 header 中某字段,用
-D -输出到 stderr 再 grep:curl -s -D - -o /dev/null https://example.com 2>&1 | grep "Content-Length"
真正麻烦的是那些要求带 Cookie、重试逻辑、或需配合 OAuth Bearer Token 的场景——curl 本身不维护会话,每次都要手动传 -b 或 -H "Authorization: Bearer ...",稍复杂就该考虑用 httpie 或写个简单脚本封装了。










