Postman不支持JSON文件直接映射为x-www-form-urlencoded表单参数；必须通过Pre-request Script结合pm.iterationData.toObject()动态注入字段，或改用raw+JSON格式提交。
Postman 本身不支持直接用 JSON 文件为 x-www-form-urlencoded 表单提交提供参数 —— 这是常见误解的根源。JSON 文件只能用于参数化（即 Collection Runner 中的 Data 驱动），但表单字段必须由 Postman 按照 application/x-www-form-urlencoded 的编码规则序列化，而 JSON 文件里的结构不会自动映射到表单键值对。
为什么 JSON 文件不能直接填进 x-www-form-urlencoded Body
当你在 Body 中选择 x-www-form-urlencoded，Postman 会把每一行 Key-Value 拼成 key1=value1&key2=value2 并设 Content-Type: application/x-www-form-urlencoded。但 JSON 文件（如 {"username":"a","password":"b"}）不是键值对列表，它是一个对象结构；Postman 不会解析该 JSON 并自动展开成表单字段。
常见错误现象：
– 导入 JSON 文件后，在 Collection Runner 里选中它，运行时所有请求都报 400 或字段缺失
– 在 Pre-request Script 中用 pm.iterationData.get("username") 能取到值，但没手动写进表单字段，Body 仍是空的
- JSON 文件只提供数据源，不自动绑定到表单字段
-
x-www-form-urlencodedBody 必须显式填写或脚本注入，不能靠“自动映射” - 若误把 JSON 字符串整个粘贴进 raw Body 并设 Content-Type 为 form-urlencoded，服务器会收到非法格式（比如
{"username":"a"}被当做一个 key 名，无 value）
正确做法：用 iterationData + Pre-request Script 注入表单字段
这是唯一可靠的方式。前提是你的 JSON 文件是数组形式（每项一个测试用例）：
[{"username":"test1","password":"123456"},{"username":"test2","password":"654321"}]
然后在目标请求的 Pre-request Script 中写：
Postman 12.27.7 Windows x64 官方安装包，适用于 API 设计、调试、测试与协作。该系列包含 Enterprise 云端性能测试静态 IP 出口能力，以及接口规范标签管理改进，适合受限网络测试与规范资源组织场景。
const data = pm.iterationData.toObject();
pm.request.body.update({
mode: 'urlencoded',
urlencoded: [
{ key: 'username', value: data.username, enabled: true },
{ key: 'password', value: data.password, enabled: true }
]
});
- 必须用
pm.iterationData.toObject()，不能用.get()逐个取 —— 否则无法保证字段顺序和完整性 -
pm.request.body.update()是动态重写整个表单体，比手动勾选字段更可控 - 如果表单字段名和 JSON 键名不一致（如 JSON 里叫
user_name，但接口要username），需在脚本里做映射
替代方案：改用 raw + JSON 格式提交（更简单）
如果你能控制接口接受 application/json，那就跳过表单限制：
- Body →
raw→ 左下角选JSON - 内容直接写
{{username}}和{{password}}（前提是 JSON 数据文件字段名匹配） - Postman 会自动把
{{}}替换，并设好Content-Type: application/json
这种写法不需要 Pre-request Script，也不依赖表单模式，出错率低得多。但前提是后端真的接收 JSON —— 很多老系统只认 x-www-form-urlencoded，这点必须确认清楚。
导入 JSON 文件失败的三个高频原因
即使走参数化路线，导入也常卡住：
- JSON 文件不是合法数组：Collection Runner 要求顶层必须是
[]，单个对象{}会报Data file is not valid JSON array - 文件编码含 BOM：用 VS Code 打开 → 右下角点编码 → 选
UTF-8（不要UTF-8 with BOM）→ 保存 - 字段名含空格或特殊字符：如
"user name"在脚本里要用data["user name"]，但容易漏引号导致undefined
最易被忽略的是第一点：很多人导出配置 JSON 是单对象，却没包一层数组就丢进 Runner，结果一直提示“Data preview is empty”。
