Postman CSV Runner怎么配置或排查

用 Postman 批量测接口时，CSV Runner 最容易卡在三个地方：文件选了但变量还是空、请求只跑了一次、手机号或订单号被改成了科学计数法。最稳的配置顺序是先让 CSV 第一行和请求里的变量名一一对应，再在 Collection Runner 的 Iteration data 中预览文件，最后用运行结果和 Postman Console 对照当前行。

官方地址：https://www.postman.com/

先把 CSV 写成 Runner 能识别的形状

假设 collection 里有一个创建用户的请求，正文需要每次替换邮箱和昵称。CSV 不要把第一行当成普通数据，而要把它写成变量名：

email,nickname
lin@example.test,林一
chen@example.test,陈二

请求 JSON 可以这样引用：

{
  "email": "{{email}}",
  "nickname": "{{nickname}}"
}

上面的 JSON 本身不支持注释，所以字段含义放在代码块外说明。email 和 nickname 必须和 CSV 表头逐字一致，不能把 nickname 写成 nickName。CSV 每行还要有相同的列数，并尽量使用 Unix 换行；逗号、双引号和换行出现在字段内部时，要按 CSV 规则转义。

步骤一：从 Collection 进入 Runner

在左侧打开 Collections，选中要执行的 collection 或文件夹，点击右侧的 Run。进入运行配置后，确认 Run type 为 Functional，本地手动执行选择 Local。如果你看到的是空的请求列表，先回到 collection 检查是否真的选中了文件夹，而不是只选中了工作区。

步骤二：选择 CSV、预览列名并设置迭代次数

找到 Iteration data，切换到 Datafiles，选择本地 CSV，然后先点预览，不要直接开始运行。预览中应能看到 email、nickname 两列和两行数据。接着把 Iterations 设为 2，让它和当前文件行数一致；行数较多时，也可以先用 1 行做冒烟验证，再扩大范围。

如果预览列名变成一整列，常见原因是导出文件使用了分号分隔；如果行数对不上，检查是否有空行、隐藏换行或某一行少了一个逗号。长于 15 位的数字不要直接交给表格软件按数值导出，订单号、手机号、带前导零的编码应在预览时明确指定为字符串，避免文件生成阶段就丢失原值。

步骤三：用运行结果确认当前行真的进入请求

点击 Run 后，先看总迭代数，再点开具体请求。成功的判断不是“Runner 跑完了”，而是每一行都使用了自己的数据。需要在脚本里核对当前值时，可以加入一段简短的断言：

// 读取当前迭代的邮箱，缺失时立即让本轮测试失败
const email = pm.iterationData.get("email");
pm.test("CSV email 已注入", function () {
  pm.expect(email, "当前行缺少 email").to.be.a("string").and.not.empty;
});
console.log("当前迭代邮箱:", email);

脚本只负责检查当前行，不会改变 CSV。打开底部的 Console，按迭代顺序观察日志；若两次日志都是同一个值，先查是否真的选中了 Datafiles，再查是否把请求值写死在环境变量或 collection 变量里。

四类症状的排查清单

还有一个容易误判的覆盖问题：同名变量可能同时存在于环境、collection 和 CSV。CSV 数据变量只在本次运行中生效，调试时应从 Runner 的预览和 Console 追踪当前值，不要只看右上角环境变量面板。若任务需要定时运行、复用数据或处理大规模数据，官方文档建议进一步考虑 Postman Dataset，而不是把越来越大的静态 CSV 继续塞进手动运行。

常见问题

CSV 表头必须和请求变量完全一样吗？

是。变量名区分大小写，user_id、userId 和 User_Id 会被当成不同名字。

能不能在脚本里修改 CSV 数据变量？

CSV 数据变量来自外部文件，不能在 Postman 里直接持久修改；可以用 pm.iterationData.get() 读取并做校验或转换。

为什么文件预览正常，接口仍收到旧值？

先检查请求是否仍引用了环境变量或固定文本，再查看 Console 中当前迭代值；确认 CSV 变量名没有被同名的固定配置覆盖。

验收时只看四件事：预览列名正确、每行列数一致、迭代次数符合预期、Console 中的当前行值和请求结果能对应起来。四项都成立，Postman CSV Runner 的配置就基本闭环了。