Postman接口测试怎么设置环境变量和断言

文章导读
在 Postman 里做接口测试,环境变量负责把 baseUrl、token、测试账号这类会随环境变化的东西抽出来,断言负责判断一次请求的返回是否真的符合预期。通常的做法是:在 Environment 里定义变量,在请求的 URL、Headers、Body 里用 {{变量名}} 引用,把“取响应字段写回变量”和“校验状态码、业务码、关键字段”这两件事都放在请求的 Tests 标签页里用 pm.*
📋 目录
  1. A 先确认当前场景和目标
  2. B 按这个顺序处理
  3. C 改完后怎么验证
  4. D 容易忽略的边界
A A

在 Postman 里做接口测试,环境变量负责把 baseUrl、token、测试账号这类会随环境变化的东西抽出来,断言负责判断一次请求的返回是否真的符合预期。通常的做法是:在 Environment 里定义变量,在请求的 URL、Headers、Body 里用 {{变量名}} 引用,把“取响应字段写回变量”和“校验状态码、业务码、关键字段”这两件事都放在请求的 Tests 标签页里用 pm.* 脚本完成。先小范围跑通一个登录加一个业务接口,再考虑批量。

判断这件事是否该做,看两点:同一套接口是否要在多个域名或账号下重复跑,以及返回结果是否需要人工肉眼比对。满足任意一条,就值得配置环境变量和断言。操作上建议先建立 Environment 存放 baseUrl 和账号,再用 Tests 脚本把登录返回的 token 写入环境变量,最后用状态码加业务码做双层断言。验证方式是切换环境重新 Send,观察 Test Results 全绿且 Environment 中变量值被更新。边界在于变量作用域优先级、token 过期、以及导出的环境文件会包含明文敏感值,这些需要提前约定。

先确认当前场景和目标

动手前先确认三件事,否则后面容易反复改。

  • 哪些值随环境变化:常见的是接口域名、网关地址、appKey、测试账号、租户标识。只有这些进 Environment,接口路径、请求方法这类固定内容不需要进变量。
  • 变量放在哪一层:如果只有一个环境,放 Collection 变量也能用;需要切测试、预发两套配置时,用 Environment 更清晰,同一集合可以配多份环境。
  • 断言要判断什么:至少确认 HTTP 状态码,其次确认返回体里的业务码或 success 字段,再对关键字段的存在性和类型做校验。不要只断言状态码 200,很多网关出错也会返回 200。

另外确认团队用的 Postman 是否支持 pm.* 语法(较新的沙盒环境普遍支持),如果集合是别人导出的老脚本,可能还混着 tests[] 写法,改写前先确认,避免两种风格并存。

Postman接口测试怎么设置环境变量和断言

按这个顺序处理

  1. 新建 Environment,逐个添加变量。每个变量有 Initial value 和 Current value 两栏,Initial 用于导出共享,Current 是本地实际生效值,脚本读到的是 Current。
  2. 在请求里引用变量:URL 写成 {{baseUrl}}/api/v1/login,Header 写 Authorization: Bearer {{token}}。右上角环境下拉框要选到对应环境,否则 {{baseUrl}} 会原样发出去。
  3. 在登录请求的 Tests 标签页里取 token 并写回环境变量。字段路径按实际返回结构调整,下面是通用骨架:
// Tests 标签页:登录成功后保存 token
const body = pm.response.json();

pm.test("状态码为 200", function () {
    pm.response.to.have.status(200);
});

pm.test("返回体包含 access_token", function () {
    pm.expect(body).to.have.property("data");
    pm.expect(body.data).to.have.property("access_token");
});

// 写入环境变量,键名要和 Header 里引用的名字一致
if (body.data && body.data.access_token) {
    pm.environment.set("token", body.data.access_token);
}
  1. 业务接口的断言同样放在 Tests 里,做状态码、业务码、字段类型三层校验。字段名、业务成功码按自己接口替换:
// Tests 标签页:业务接口断言
pm.test("状态码为 200", function () {
    pm.response.to.have.status(200);
});

pm.test("业务码为 0", function () {
    pm.expect(pm.response.json().code).to.eql(0);
});

pm.test("列表字段结构正确", function () {
    const list = pm.response.json().data.list;
    pm.expect(list).to.be.an("array");
    if (list.length > 0) {
        pm.expect(list[0]).to.include.keys("id", "status");
    }
});

如果某些请求必须在发出去之前准备数据,比如时间戳、随机单号,可以放在 Pre-request Script 里用 pm.variables.set 生成。这类值一般只对当前请求有效,用局部变量比写环境变量更合适,避免脏值残留。

改完后怎么验证

先单个请求 Send,看下方的 Test Results 区域:每个 pm.test 对应一条结果,全绿说明断言通过;出现红色就展开看具体是哪一行 pm.expect 不满足,通常能直接定位到字段路径写错或返回结构变了。

接着验证变量是否真的写进去了:打开 Environment 的快速查看面板,确认 token 的 Current value 已经变成一段非空字符串;或者临时在 Tests 里加一行 console.log(pm.environment.get("token")),打开 Console 查看输出,确认后删掉这行,避免日志噪声。

Postman接口测试怎么设置环境变量和断言

最后做一次环境切换验证:把环境下拉框切到另一套配置,重新跑登录和业务请求,如果 baseUrl 真的换了、断言仍然通过,说明变量引用没有硬编码。有条件的话用 Collection Runner 跑一遍整个集合,观察每个请求的断言结果和依赖顺序。

容易忽略的边界

  • 变量作用域有优先级:局部变量和 data 文件变量会覆盖环境变量,环境变量又覆盖集合变量和全局变量。同名变量出现在两层时,脚本拿到的可能不是你以为的那个值,命名上加前缀更容易排查。
  • 变量值不会被二次解析:如果环境变量里存了 {{host}} 这样的内容,请求里不会展开成真实地址。
  • token 会过期。长时间不跑再执行时,断言失败可能只是凭证失效,不一定是用例写错,先手动重跑登录请求刷新变量。
  • 导出的环境文件里 Initial value 是明文,涉及密码、密钥的环境不建议直接提交到仓库,可以只保留占位值,本地手动填 Current value。
  • 脚本运行在沙盒里,不能直接用 Node 的 fs、require 等模块;需要加密或签名时,一般要预先算好放进变量,或者用 Postman 提供的内置库。
  • 如果响应不是 JSON,pm.response.json() 会抛错导致后续断言不执行,这类接口可以先判断 Content-Type,或者改用文本匹配回退处理。

拿不准变量层级时,最稳的回退方式是先只用一个 Collection 变量把路径跑通,确认断言逻辑正确后,再把与环境相关的值迁移到 Environment,一步一步来比一次性铺开更容易定位问题。