Postman Runner 怎样用数据文件批量执行请求

我在给同一组接口换多份测试账号时，最容易踩的坑不是请求本身，而是把环境变量、迭代数据和 Runner 的执行次数混在了一起。Postman Runner 的正确用法是：请求里保留 {{变量名}}，再在运行配置里选择 CSV 或 JSON 数据文件，让每一行数据对应一次迭代。

官方地址：https://learning.postman.com/docs/tests-and-scripts/running-collections/test-data/working-with-data-files

先把请求变量和数据列对齐

假设 collection 里有一个登录接口，URL、请求体或请求头分别引用 {{email}}、{{password}} 和 {{tenant}}。数据文件只负责提供每轮变化的值，不负责保存固定的服务地址；固定地址仍可放在 environment 中。

email,password,tenant
alice@example.test,alpha-001,beijing
bob@example.test,beta-002,shanghai

CSV 的第一行是字段名，后面每一行是一轮迭代。不要把列名写成 user_email，却在请求里写 {{email}}；Runner 能读取文件，但不会替你猜字段映射。

如果更适合表达嵌套对象，可以使用 JSON 数组：

[
  {"email":"alice@example.test","password":"alpha-001","tenant":"beijing"},
  {"email":"bob@example.test","password":"beta-002","tenant":"shanghai"}
]

上面的 JSON 必须保持为有效 JSON，所以不在代码块中添加注释；字段含义直接在正文说明。真实账号、Token 和个人数据不要写进文章或共享文件。

在 Runner 里选择数据文件并预览

打开 collection 或目标文件夹的运行入口，进入 Runner 配置。找到迭代数据区域后，选择本地 CSV 或 JSON 文件，先看预览表格中的列名和行数，再决定是否开始运行。

1. 打开要执行的 collection，进入 Runner。
2. 在迭代数据区域选择 Data file 或本地数据文件入口。
3. 选择 CSV/JSON 文件，确认预览里的字段名与请求变量一致。
4. 把 Iterations 留给数据行驱动；不要为了“多跑几次”盲目填一个大于数据行数的数字。

如果预览为空，先检查文件是否真的是 UTF-8 文本、CSV 是否有表头、JSON 顶层是否为数组。文件能被文本编辑器打开，并不代表 Runner 能按预期识别字段。

迭代次数和变量作用域要分开看

一次 Runner 执行可以包含多次 iteration。数据文件提供的是每次迭代的临时值；environment 和 collection 变量提供的是更稳定的配置。排查替换结果时，优先确认数据变量确实被请求引用，而不是只检查环境下有没有同名变量。

文章只讨论变量和迭代数据，不延伸到脚本生成数据、数据库数据集或云端调度。需要重复同一组输入时可以手动设置迭代次数；需要每轮换值时，应让数据文件成为输入源。

运行后按迭代查看结果

点击运行后，不要只看最后一条响应。结果面板应能区分总迭代数、成功与失败的请求，并允许你点开某一轮查看当时使用的输入和响应。这样才能判断是第二行数据有问题，还是所有请求都没有完成变量替换。

Iterations: 2
Iteration 1: passed
Iteration 2: failed - tenant value rejected

上面是结果形状的示意，不是某次真实运行日志。若每一轮请求都发送了同一个邮箱，优先回到请求模板检查变量名；若只有一行失败，优先检查那一行的字段值和接口业务约束。

数据不生效时按四个位置回退

1. 字段名不一致：把请求中的 {{email}} 与文件表头逐字比较，注意大小写和下划线。
2. 文件格式不合适：CSV 需要清晰表头，JSON 需要有效数组和对象字段；先用 Runner 预览确认，而不是只看文件扩展名。
3. 变量作用域冲突：同名变量可能来自迭代数据、环境或 collection，先改成一个明显的测试值，观察请求预览中最终替换结果。
4. 迭代次数填错：次数大于数据行数时可能出现空值或重复判断；先恢复由数据行驱动的设置，再逐轮查看结果。

如果只是临时验证一行数据，可以先不用文件，直接在当前环境里填写变量；确认请求模板正确后，再把同样的字段迁移到 CSV/JSON 批量执行。这样回退成本最低，也更容易定位到底是请求问题还是数据文件问题。

常见问题

CSV 的列名一定要和变量名相同吗？

建议相同。这样可以直接用 {{列名}} 读取迭代数据，少一层人工映射；如果列名不同，就要在请求模板或脚本中明确转换。

JSON 文件可以只放一个对象吗？

面向多轮 Runner 执行时，优先使用对象数组，让每个对象代表一轮数据。单对象结构不适合作为多行迭代输入，遇到预览异常时先改成数组再排查。

为什么运行次数正确但请求仍然重复？

通常是请求没有引用迭代变量，或引用的变量名与文件字段不同。先打开单轮详情或请求预览，看最终替换后的值是否随行号变化。