Postman v10+需先选raw再点右侧下拉箭头选择JSON,否则Content-Type不会自动设为application/json,易致415错误;JSON语法须严格合规,引号用英文双引号、无尾逗号、换行需转义;手动添加的Content-Type会覆盖自动设置;URL中可直接带query参数,body保持纯JSON。

Postman Body 选 raw 但没出现 JSON 选项
Postman 新版本(v10+)默认不直接显示“JSON”下拉项,而是把格式选择藏在 raw 右侧的文本框旁——必须先点开那个小箭头,才能看到 JSON。如果只点了 raw 却没点下拉,Content-Type 不会自动设为 application/json,后端大概率返回 415 Unsupported Media Type。
常见错误现象:415 Unsupported Media Type、后端收不到参数、req.body 为空对象。
- 确认已点击
Body标签页 → 选中raw→ 再点击右侧下拉箭头 → 选择JSON - 选完
JSON后,Postman 会自动在Headers里加一条Content-Type: application/json;如果手动删过,得补上 - 若下拉菜单里没有
JSON,说明你用的是极简版或旧版 Lite 插件,需升级到桌面版
选了 JSON 但服务器仍报解析失败
根本原因不是 Postman 没发,而是发的内容不符合 JSON 语法。Postman 不校验 JSON 合法性,只负责原样发送字符串——哪怕多一个逗号、中文引号、尾部逗号,后端 JSON.parse() 就会直接 throw error。
使用场景:调试 Spring Boot、Express、Django 等框架时,这类错误最常出现在开发联调初期。
- 检查所有引号是否为英文双引号
",禁止用中文全角“” - 数组末尾、对象末尾不能有逗号,例如
{"name":"a",}是非法的 - 字符串值里如果含换行,必须用
\n转义,不能直接回车 - 不确定格式是否合法?粘贴到 Body 后,点右上角
Beautify按钮——成功则缩进整齐,失败则弹红框提示具体哪一行出错
想发 JSON 但 Header 里 Content-Type 被覆盖了
Postman 在选 JSON 后自动加的 Content-Type: application/json 是「非覆盖式」的:如果你在 Headers 标签页手动加了一条同名 header,那条手动添加的会生效,自动加的会被忽略——且不会提示冲突。
Postman 12.27.7 Windows x64 官方安装包,适用于 API 设计、调试、测试与协作。该系列包含 Enterprise 云端性能测试静态 IP 出口能力,以及接口规范标签管理改进,适合受限网络测试与规范资源组织场景。
性能影响:Content-Type 错误会导致后端跳过 body 解析逻辑,请求体被丢弃,响应延迟反而变低(因为压根没处理)。
- 打开
Headers标签页,查找是否有手动添加的Content-Type行 - 如果有,删掉它;或者把值改成
application/json并勾选左侧启用开关 - 不想依赖自动行为?干脆关掉自动设置:Settings → General → 取消勾选
Automatically persist request headers
POST 请求带 query 参数 + JSON body 怎么配
这是真实高频场景:比如调用微信接口 /cgi-bin/tags/create?access_token=xxx,既要 URL 带 access_token,又要 body 发 JSON 数据。容易踩的坑是把 token 塞进 body 或 header,导致鉴权失败。
正确做法非常简单,但新手常绕弯:
- URL 输入框里直接写完整地址,例如:
https://api.weixin.qq.com/cgi-bin/tags/create?access_token={{token}} -
Body→raw→ 下拉选JSON→ 输入标准 JSON,如:{"tag":{"name":"test"}} - 别在
Headers里重复加access_token,也别把它当 JSON 字段塞进 body - 如果要用环境变量,确保
{{token}}已在当前环境定义好,否则 URL 里会字面量显示{{token}},请求直接 400
复杂点在于:多个环境切换时,query 参数和 body JSON 的组合容易漏测——比如测试环境 token 有效,预发环境却忘了更新变量值,错误沉默地返回 {"errcode":40001,"errmsg":"invalid credential"},而不是明显报错。

















