Linux下如何使用curl调试接口 常用请求参数汇总

云萱酱_9706

云萱酱_9706

2026-05-04

948人浏览

原创

curl 发送 get 请求需手动 url 编码特殊字符,推荐用 -g 与 --data-urlencode;post 提交 json 必须设 content-type: application/json 且 body 为合法 json;调试用 -v 查看请求响应,-l 跟重定向,--max-time 控制超时,-k 临时跳过证书验证。

linux下如何使用curl调试接口 常用请求参数汇总

curl 发送 GET 请求时如何带查询参数和请求头

直接拼接 URL 是最常见做法,但要注意 URL 编码问题;curl 不会自动编码空格、中文等字符,手动用 urlencode 或改用 --data-urlencode 更稳妥。

加请求头统一用 -H,多个头可重复使用;Content-Type 不是必须的,GET 请求一般不带 body,所以多数情况下不用设。

  • curl "https://api.example.com/users?id=123&name=test"(简单参数,无特殊字符可用)
  • curl -G "https://api.example.com/users" --data-urlencode "name=张三" --data-urlencode "tag=web dev"(-G 表示把 data 转为 query string,自动编码)
  • curl -H "Authorization: Bearer abc123" -H "Accept: application/json" "https://api.example.com/me"

POST 提交 JSON 数据时为什么老是 400 或 415

两个关键点:必须显式声明 Content-Type: application/json,且 body 必须是合法 JSON 字符串——引号要双引号、不能有尾逗号、布尔值不能写成小写 true 以外的形式。

用 -d 传原始字符串最直接,但注意 shell 中单引号包裹可避免变量展开和转义干扰;如果 JSON 太长,建议用 @file.json 方式读取文件。

Obsidian (Linux)
Obsidian (Linux)

操作 Obsidian 库(纯 Markdown 笔记),并通过 notesmd-cli 实现自动化。

下载
  • curl -X POST -H "Content-Type: application/json" -d '{"username":"alice","active":true}' https://api.example.com/users
  • curl -X POST -H "Content-Type: application/json" -d @./payload.json https://api.example.com/users
  • 错误示例:-d "{username: 'alice'}"(key 没双引号、字符串用单引号 → 解析失败)

调试时如何查看完整请求与响应细节

用 -v(verbose)能看到完整的 HTTP 请求行、所有请求头、响应状态行、响应头,以及响应 body 的开头部分;但它默认截断大响应体,加 --include 可强制显示响应头+完整 body,加 --output /dev/stdout 防止被重定向吞掉内容。

注意 -v 输出里请求体是看不到的(除非用 --trace-ascii),真正想确认发了什么 body,建议先用 echo 或 cat 看原始 payload,再发请求。

  • curl -v -X POST -H "Content-Type: application/json" -d '{"x":1}' https://httpbin.org/post
  • curl -v --include https://httpbin.org/status/404(同时看 header 和 body)
  • curl --trace-ascii /dev/stdout -d "a=1&b=2" https://httpbin.org/post(显示原始二进制级请求流,含 body)

处理重定向、超时和证书验证失败

默认 curl 不跟随 3xx 重定向,加 -L 才会跳;超时分连接超时(--connect-timeout)和总超时(--max-time),后者更常用;HTTPS 报 SSL certificate problem 通常是因为服务端用了自签名证书或系统 CA 未更新,临时调试可加 -k 跳过验证,但生产环境绝不能用。

  • curl -L https://httpbin.org/redirect/3(最多跟随 50 次,默认上限)
  • curl --max-time 10 https://slow-api.example.com(10 秒内没完成就退出)
  • curl -k https://self-signed.badssl.com(仅调试,忽略证书错误)
  • 长期解决证书问题:更新系统 CA 包(如 Ubuntu 的 ca-certificates),或指定私有 CA 路径:--cacert ./my-ca.pem
实际调试中,最容易被忽略的是请求体编码格式和服务器期望的 Content-Type 是否严格匹配——比如后端只认 application/json;charset=utf-8,而你只写了 application/json,某些框架会直接拒收。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

linux curl

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
硬盘接口类型介绍
硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍:1、IDE接口是一种并行接口,主要用于连接硬盘和光驱等设备,它主要有两种类型:ATA和ATAPI,IDE接口已经逐渐被SATA接口;2、SATA接口是一种串行接口,相较于IDE接口,它具有更高的传输速度、更低的功耗和更小的体积;3、SCSI接口等等。

2023.10.19

3148

3

PHP接口编写教程
PHP接口编写教程

本专题整合了PHP接口编写教程,阅读专题下面的文章了解更多详细内容。

2025.10.17

4869

12

php8.4实现接口限流的教程
php8.4实现接口限流的教程

PHP8.4本身不内置限流功能,需借助Redis(令牌桶)或Swoole(漏桶)实现;文件锁因I/O瓶颈、无跨机共享、秒级精度等缺陷不适用高并发场景。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2025.12.29

3789

9

java接口相关教程
java接口相关教程

本专题整合了java接口相关内容,阅读专题下面的文章了解更多详细内容。

2026.01.19

446

15

磁盘配额是什么
磁盘配额是什么

磁盘配额是计算机中指定磁盘的储存限制,就是管理员可以为用户所能使用的磁盘空间进行配额限制,每一用户只能使用最大配额范围内的磁盘空间。php中文网为大家提供各种磁盘配额相关的内容,教程,供大家免费下载安装。

2023.06.21

4070

4

如何安装LINUX
如何安装LINUX

本站专题提供如何安装LINUX的相关教程文章,还有相关的下载、课程,大家可以免费体验。

2023.06.29

3473

10

linux find
linux find

find是linux命令,它将档案系统内符合 expression 的档案列出来。可以指要档案的名称、类别、时间、大小、权限等不同资讯的组合,只有完全相符的才会被列出来。find根据下列规则判断 path 和 expression,在命令列上第一个 - ( ) , ! 之前的部分为 path,之后的是 expression。还有指DOS 命令 find,Excel 函数 find等。本站专题提供linux find相关教程文章,还有相关

2023.06.30

2673

5

linux修改文件名
linux修改文件名

本专题为大家提供linux修改文件名相关的文章,这些文章可以帮助用户快速轻松地完成文件名的修改工作,大家可以免费体验。

2023.07.05

6510

7

linux系统安装教程
linux系统安装教程

linux系统是一种可以免费使用,自由传播,多用户、多任务、多线程、多CPU的操作系统。本专题提供linux系统安装教程相关的文章,大家可以免费体验。

2023.07.06

6142

7

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习

Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Valgrind支持平台说明
Valgrind支持平台说明

共0课时 | 0人学习