Postman 环境变量与 Tests 断言实战:一套请求切换开发、测试、生产
接口联调时,最容易出错的动作不是写请求参数,而是反复修改地址:开发环境一个域名,测试环境一个域名,线上环境又是另一个域名。Postman 的环境变量可以把这件事收起来,再配合 Tests 断言,发送请求后就能快速判断接口是否符合预期。
摘要
本文用 Postman 做一个完整的小流程:创建 DEV、TEST、PROD 三套环境变量,把请求地址里的域名替换成 {{base_url}},发送请求后用 Tests 检查状态码和 JSON 字段。这样同一套请求可以在多个环境间切换,避免手动改地址,也方便团队共享。
适合人群
适合正在做接口联调、后端自测、前后端协作、自动化接口冒烟测试的同学。你只需要会在 Postman 里创建请求、点击 Send,并能读懂一点 JavaScript 断言代码。
目录
- 先把 base_url 抽成环境变量
- 请求里使用变量
- 用 Tests 检查状态码和 JSON 字段
- 常见问题和排查方式
- 参考资料
先把 base_url 抽成环境变量
在 Postman 里,不同环境的变量可以放到 Environment 中管理。比如我们定义一个变量名 base_url,然后分别给 DEV、TEST、PROD 三套环境配置不同值。

一个常见配置可以这样设计:
- DEV:
http://dev.api.example.com - TEST:
http://test.api.example.com - PROD:
https://api.example.com
变量名建议保持稳定,例如统一叫 base_url。这样 Collection 里的所有请求都能复用同一个变量,不需要每个请求单独维护一份域名。
请求里使用变量
配置好环境后,请求地址就可以从固定域名改成变量写法:
{{base_url}}/api/users?page=1&size=10
发送请求前,先在右上角选择当前环境。选中 DEV 时,请求会走开发地址;切到 TEST 时,同一条请求会走测试地址。这个习惯能明显减少“把测试参数发到错误环境”的问题。
建议的变量命名
base_url:接口基础地址。token:当前环境登录令牌。tenant_id:多租户系统的租户标识。user_id:测试用户 ID,适合团队共享样例请求。
如果变量是敏感值,建议只保存在本地当前值里,不要把真实密钥直接提交到共享 Collection。
用 Tests 检查状态码和 JSON 字段
只看响应 Body 容易漏问题。Postman 的 Tests 可以在响应返回后自动检查结果,例如状态码是否为 200、返回 JSON 里是否包含指定字段。

在请求的 Tests 面板里,可以写入下面这段:
pm.test("状态码应为 200", function () {
pm.response.to.have.status(200);
});
pm.test("返回 user.id 应等于请求 ID", function () {
const jsonData = pm.response.json();
pm.expect(jsonData.user.id).to.eql(1001);
});
pm.test("返回 user.name 不为空", function () {
const jsonData = pm.response.json();
pm.expect(jsonData.user.name).to.be.a("string").and.not.empty;
});
点击 Send 后,Postman 会在 Test Results 里显示通过或失败。接口字段变更、状态码异常、数据为空,都能第一时间看到。
把环境变量和 Tests 组合起来
更实用的做法是把变量也放进断言里。比如从环境变量读取当前测试用户 ID,再和响应里的用户 ID 对比。
pm.test("返回 ID 与环境变量一致", function () {
const expectedUserId = Number(pm.environment.get("user_id"));
const jsonData = pm.response.json();
pm.expect(jsonData.user.id).to.eql(expectedUserId);
});
这样同一套请求在不同环境下只要切换变量,就能复用同一组断言。
常见问题和排查方式
- 变量没有生效:确认右上角已经选中正确 Environment,并且变量名和请求里的写法一致。
- 请求地址出现空白:检查
base_url是否有当前值,不要只填了初始值却没有保存。 - Tests 一直失败:先在 Body 里确认返回结构,再检查字段路径是否写错。
- 切到 PROD 很危险:线上环境建议使用只读账号或只读接口,避免误操作。
- 团队共享变量:共享 Collection 时保留变量名和示例值,真实 token 让每个人自己填写。
参考资料
总结
Postman 的环境变量解决的是“多环境地址不要反复手改”,Tests 解决的是“请求返回后自动判断是否符合预期”。把 base_url、token、user_id 这类变量整理好,再给关键接口加上状态码和 JSON 字段断言,一套请求就能在开发、测试、生产之间稳定复用。
AI Agent 工具权限分级实战:读、写、发布三类操作怎么管
- 上一篇
- AI Agent 工具权限分级实战:读、写、发布三类操作怎么管
- 下一篇
- Go 问答:append 后原 slice 为什么有时会变,有时不会
-
- 文章 · 软件教程 | 4小时前 | 软件教程 · OBS Studio · 录屏 · 视频录制 · 软件教程 录屏设置 OBS Studio 窗口采集 音频混音器 录制路径
- OBS Studio 录屏设置实战:窗口采集、音频检查和录制路径这样配
- 105浏览 收藏
-
- 文章 · 软件教程 | 1星期前 |
- 小红书双击点赞怎么用?实用互动技巧
- 397浏览 收藏
-
- 文章 · 软件教程 | 1星期前 |
- Word插入Excel表格制作教程
- 460浏览 收藏
-
- 文章 · 软件教程 | 1星期前 |
- 按住Ctrl组合图形无效解决方法
- 296浏览 收藏
-
- 文章 · 软件教程 | 1星期前 |
- 开启Windows 11硬件加速视频解码方法
- 351浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- ChatExcel酷表
- ChatExcel酷表是由北京大学团队打造的Excel聊天机器人,用自然语言操控表格,简化数据处理,告别繁琐操作,提升工作效率!适用于学生、上班族及政府人员。
- 8144次使用
-
- Any绘本
- 探索Any绘本(anypicturebook.com/zh),一款开源免费的AI绘本创作工具,基于Google Gemini与Flux AI模型,让您轻松创作个性化绘本。适用于家庭、教育、创作等多种场景,零门槛,高自由度,技术透明,本地可控。
- 8572次使用
-
- 可赞AI
- 可赞AI,AI驱动的办公可视化智能工具,助您轻松实现文本与可视化元素高效转化。无论是智能文档生成、多格式文本解析,还是一键生成专业图表、脑图、知识卡片,可赞AI都能让信息处理更清晰高效。覆盖数据汇报、会议纪要、内容营销等全场景,大幅提升办公效率,降低专业门槛,是您提升工作效率的得力助手。
- 8397次使用
-
- 星月写作
- 星月写作是国内首款聚焦中文网络小说创作的AI辅助工具,解决网文作者从构思到变现的全流程痛点。AI扫榜、专属模板、全链路适配,助力新人快速上手,资深作者效率倍增。
- 10306次使用
-
- MagicLight
- MagicLight.ai是全球首款叙事驱动型AI动画视频创作平台,专注于解决从故事想法到完整动画的全流程痛点。它通过自研AI模型,保障角色、风格、场景高度一致性,让零动画经验者也能高效产出专业级叙事内容。广泛适用于独立创作者、动画工作室、教育机构及企业营销,助您轻松实现创意落地与商业化。
- 9193次使用
-
- 后台接收不到axios发送的post数据
- 2023-01-27 435浏览
-
- VS Code Dev Containers 实战:用容器搭建一致开发环境
- 2026-06-12 182浏览
-
- Docker Compose 本地多服务环境实战:MySQL、Redis、Nginx 一键启动
- 2026-06-12 250浏览
-
- Git worktree 实战:一套仓库并行修 Bug 和开发新功能
- 2026-06-12 447浏览
-
- Nginx 本地 HTTPS 反向代理实战:前后端联调不再改端口
- 2026-06-12 373浏览

