适用范围与准备

适用于自己或获准测试的 JSON POST 接口,curl 能连接却返回 415、400,或服务提示正文类型不对。状态码只是线索,具体含义以该接口返回和文档为准;不要对正式创建、付款或修改接口反复试提交。

先区分原因

--data 默认按表单类型发送,正文长得像 JSON 不会自动改变媒体类型。curl 7.82.0 起的 --json 会按原始字节提交并设置 JSON 请求与接收头,但不会检查 JSON 语法,也不会把两个对象自动合并成一个。

按顺序操作

  1. 记录完整状态和脱敏错误,核对接口是否要求 JSON、字段结构以及认证。确认实际 curl 版本支持 --json;PowerShell 明确用 curl.exe,避免同名命令混淆。
  2. 在新的测试目录用编辑器保存 UTF-8 的 payload.json,内容先用下方无敏感字段示例,并用已有 JSON 工具验证语法。文件方式能减少不同终端对引号的处理差异;字段仍须按测试接口说明修改。
  3. 执行下方单次 POST,只向获准的测试端点发送。--json @payload.json 会读取本地文件;它同时表达 Content-Type: application/json 与 Accept: application/json,但服务不一定返回 JSON,仍需读取实际响应。
  4. 若媒体类型问题消失但返回字段校验错误,继续按接口结构修正文。不要反复加 --json 企图合并对象;多次使用会连接文本片段,可能产生无效 JSON。
  5. curl --fail 遇到 HTTP 错误会返回非零,且不输出错误正文。需要排错正文时,在已控制的单次测试中采用能保留错误体的方式,并同时核对 HTTP 状态;不能把退出码零等同于业务成功。
payload.json 的无敏感演示内容;具体字段必须满足你自己的测试接口。
{"message":"hello","enabled":true}
PowerShell;macOS/Linux 改为 curl。会提交一次 POST,并写入响应头和正文文件。
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 说明排障进入了下一层,不能写成请求已经成功。

无效时恢复与下一步

按原脚本需要恢复参数,保留脱敏错误样例;自己的测试文件可在验收后清理。真实接口若可能已产生记录,先核对结果再决定是否重试,不用换节点解决字段校验。