Postman 怎么用 Collection Runner 注入不同环境变量

在 Postman Collection Runner 里，一次运行只能选择一个 Environment。若要让第 1、2、3 次迭代分别使用不同的 base_url、tenant 或测试账号，正确做法不是在运行中切换多个环境，而是选择一个基准环境，再加载 CSV 或 JSON 作为 Iteration data。数据文件中的同名变量作用域更窄，会覆盖环境变量，并且只在本次运行中有效。

Postman 官方下载：https://www.postman.com/downloads/

Collection Runner 文档：https://learning.postman.com/docs/tests-and-scripts/running-collections/intro-to-collection-runs/

最小可用方案：请求继续写 {{base_url}}、{{tenant}}；Environment 保存默认值；CSV/JSON 每行提供一组同名字段；Runner 选择该环境并加载数据文件后，每一行就是一次不同变量组合。

1. 先确认为什么环境变量看起来没有变化

Collection Runner 的环境选择器位于 Postman 右上角，一次运行只绑定一个环境。Runner 不会根据数据文件逐行切换“开发环境”“测试环境”“预发布环境”三个 Environment 对象。真正按迭代变化的是数据变量。

Postman 的变量优先级从宽到窄依次为：Global、Collection、Environment、Data、Local。使用 {{base_url}} 时，如果环境和数据文件都存在 base_url，当前行的数据值会覆盖环境值；若当前行没有该字段，才会继续解析较宽作用域中的值。

2. 建立基准 Environment 并改造请求

在左侧栏选择 Environments，打开用于本次测试的环境，例如 Runner Base。点击表格底部 Add variable，加入以下默认值：

• base_url：例如测试服务的默认地址；
• tenant：例如默认租户标识；
• username：仅使用无敏感信息的测试账号；
• expected_status：例如 200。

Postman 当前的环境变量修改会自动保存。若变量值属于凭据，不要把它放进共享数据文件；应使用 Secure 变量或 Vault，并确保团队权限符合项目要求。

可见确认状态：环境名称显示为 Runner Base，四个变量均处于启用状态，并且 Value 列不为空。

接着打开 Collection 中的请求，把需要变化的位置改成变量引用。例如请求 URL 写成 {{base_url}}/api/users，请求头 X-Tenant 的值写成 {{tenant}}，JSON 请求体中的账号字段写成 {{username}}。这样请求本身保持一份，变量来源由 Runner 决定。

3. 准备每次迭代的数据文件

CSV 第一行必须是变量名，后续每一行代表一次迭代。变量名区分大小写，并且每一行列数要一致。下面的 CSV 中，base_url、tenant、username 与请求里的变量名完全相同：

base_url,tenant,username,expected_status
https://api-dev.example.test,tenant-a,user_a,200
https://api-qa.example.test,tenant-b,user_b,200
https://api-stage.example.test,tenant-c,user_c,200

CSV 本身不支持注释，因此字段说明写在代码块外：第一行是变量名，下面三行分别对应开发、测试和预发布三次迭代。示例域名使用保留用途的测试地址，不应替换成带真实密钥的生产数据。

也可以使用 JSON。格式必须是对象数组，每个对象代表一次迭代：

[
  {
    "base_url": "https://api-dev.example.test",
    "tenant": "tenant-a",
    "username": "user_a",
    "expected_status": 200
  },
  {
    "base_url": "https://api-qa.example.test",
    "tenant": "tenant-b",
    "username": "user_b",
    "expected_status": 200
  }
]

JSON 是严格数据格式，不能插入注释。选择 CSV 还是 JSON 主要看数据复杂度：表格型数据用 CSV 更直观，字段类型或嵌套需求较多时 JSON 更清晰。官方文档说明，自定义数据文件功能受套餐约束；若界面中看不到 Datafiles 选项，应先核对当前计划与工作区权限。

4. 在 Collection Runner 选择环境并载入数据

按以下路径进入 Runner：

1. 左侧 Items → Collections，选择要运行的 Collection 或文件夹。
2. 点击 Run。
3. 在 Run type 中选择 Functional，然后选择 Local。
4. 用 Postman 右上角的环境选择器选中 Runner Base。
5. 展开 Iteration data，进入 Datafiles，点击 Select from computer。
6. 选择 CSV 或 JSON，先查看 Preview，再确认字段名与行数。

可见确认状态：环境选择器显示 Runner Base，Iteration data 区域显示文件名，Preview 中能看到三行数据。此时 Iterations 通常应与数据行数一致；如果手动设置得更少，只会使用前面的行。

确认请求顺序后点击 Start run。如果只想让变化作用于本次执行，不要为了这项任务开启 Keep variable values。该选项用于保留运行过程中被脚本更新的变量，本身不是“启用数据文件覆盖”的开关。

5. 从运行结果确认每轮变量都已注入

Runner 会实时显示每个请求、测试结果、错误、迭代数和耗时。运行多次迭代时，可以点击迭代编号跳到对应结果，再打开某个请求查看最终 URL、请求头和请求体。

为了让结果更容易核对，可在请求的 Post-response 脚本中加入一条状态断言和少量日志：

// 读取本轮数据文件中的期望状态码；数据变量只在当前运行中有效。
const expected = Number(pm.iterationData.get("expected_status"));

// 验证响应状态，失败时 Runner 会直接标出该迭代。
pm.test("状态码符合本轮数据", function () {
  pm.expect(pm.response.code).to.eql(expected);
});

// 输出最终解析值，便于区分不同迭代；不要记录真实令牌或密码。
console.log({
  baseUrl: pm.variables.get("base_url"),
  tenant: pm.variables.get("tenant")
});

可见确认状态：结果页显示 3 个 Iterations，相关断言为 Passed；展开每轮请求时，最终域名和 X-Tenant 与对应数据行一致。

变量不生效时按这张表排查

常见问题

可以让同一次 Runner 自动切换多个 Environment 吗？

Runner 配置一次选择一个环境。若只是让每轮使用不同变量值，使用 CSV/JSON 数据变量覆盖同名环境变量即可。若必须分别使用多个完整 Environment 对象，应拆成多次运行或改用自动化命令分别传入环境。

为什么建议同时保留一个基准 Environment？

它可以保存不会随迭代变化的公共配置，也能给缺失字段提供明确兜底。数据文件只放需要逐轮变化的字段，文件更短，排错也更直接。

CSV 和 JSON 数据会永久修改环境变量吗？

不会。数据变量属于运行期作用域，运行结束后不持续存在。Keep variable values 控制的是运行中被脚本更新的变量是否保留，不会把每行数据自动写回 Environment。

数据行很多时还适合本地文件吗？

小而固定的数据集适合 CSV/JSON。官方文档建议在数据较大、频繁变化、需要复用或查询组合时考虑 Dataset；上传到工作区的数据文件还有大小、存储和使用范围限制。