适用范围与准备
适用于自己或获准测试的 JSON POST 接口,curl 能连接却返回 415、400,或服务提示正文类型不对。状态码只是线索,具体含义以该接口返回和文档为准;不要对正式创建、付款或修改接口反复试提交。
先区分原因
--data 默认按表单类型发送,正文长得像 JSON 不会自动改变媒体类型。curl 7.82.0 起的 --json 会按原始字节提交并设置 JSON 请求与接收头,但不会检查 JSON 语法,也不会把两个对象自动合并成一个。
按顺序操作
- 记录完整状态和脱敏错误,核对接口是否要求 JSON、字段结构以及认证。确认实际 curl 版本支持 --json;PowerShell 明确用 curl.exe,避免同名命令混淆。
- 在新的测试目录用编辑器保存 UTF-8 的 payload.json,内容先用下方无敏感字段示例,并用已有 JSON 工具验证语法。文件方式能减少不同终端对引号的处理差异;字段仍须按测试接口说明修改。
- 执行下方单次 POST,只向获准的测试端点发送。--json @payload.json 会读取本地文件;它同时表达 Content-Type: application/json 与 Accept: application/json,但服务不一定返回 JSON,仍需读取实际响应。
- 若媒体类型问题消失但返回字段校验错误,继续按接口结构修正文。不要反复加 --json 企图合并对象;多次使用会连接文本片段,可能产生无效 JSON。
- curl --fail 遇到 HTTP 错误会返回非零,且不输出错误正文。需要排错正文时,在已控制的单次测试中采用能保留错误体的方式,并同时核对 HTTP 状态;不能把退出码零等同于业务成功。
{"message":"hello","enabled":true}curl.exe --disable --connect-timeout 10 --max-time 30 --json "@payload.json" --dump-header response.headers --output response.body --write-out "%{http_code}" "https://example.com/test-json"| 检查层 | 应确认 |
|---|---|
| HTTP 请求头 | 接口接受的媒体类型 |
| JSON 语法 | 引号、逗号、括号等合法 |
| 接口字段 | 名称、类型与必填项符合约定 |
| 最终业务结果 | 按接口定义确认,不只看传输完成 |
怎样确认有效
测试接口确认收到正确类型与字段,响应状态和业务结果都符合约定。仅将 415 变成 400 说明排障进入了下一层,不能写成请求已经成功。
无效时恢复与下一步
按原脚本需要恢复参数,保留脱敏错误样例;自己的测试文件可在验收后清理。真实接口若可能已产生记录,先核对结果再决定是否重试,不用换节点解决字段校验。