讲师中心 微信公众号
AI工具推荐 视频效率加速

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

云萱酱_9706

云萱酱_9706

发布时间:2026-05-04 10:27:29

|

948人浏览过

|

来源于php中文网

原创

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 方式读取文件。

Zynq Linux Hardware Debug
Zynq Linux Hardware Debug

Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq(Cortex‑A9/A53 + FPGA)Linux 环境,调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查,支持 PetaLinux 开发。

下载
  • 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,某些框架会直接拒收。

热门AI工具

更多
火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

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

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

3148

2023.10.19

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

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

4869

2025.10.17

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

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

3789

2025.12.29

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

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

446

2026.01.19

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

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

4070

2023.06.21

如何安装LINUX
如何安装LINUX

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

3473

2023.06.29

linux find
linux find

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

2673

2023.06.30

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

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

6510

2023.07.05

OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

20

2026.10.16

热门下载

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

精品课程

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

共0课时 | 0人学习

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

共0课时 | 0人学习

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

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn