Postman中添加Example是为了复现响应、驱动Mock Server及统一团队测试预期;需手动点击“Save Response→Save as Example”保存真实响应,或通过“Add Example”手写模拟响应,保存后挂载于请求节点下,图标为小文档,且必须绑定Mock Server才能生效。

Postman 里给接口加响应示例,不是为了“存档好看”,而是为了后续快速复现特定响应、驱动 Mock Server、或在团队协作中统一测试预期——只要没手动保存为 Example,那个响应就只在当前标签页临时存在,关掉就丢。
怎么把一次真实响应存成 Example
这是最常用也最容易被忽略的路径:你刚调通一个接口,返回了理想的 200 + 正确 JSON,但没点保存,下次想重试就得再发一次请求、等后端响应、再手动复制粘贴……
- 发送请求后,在右下角响应区点击
Save Response→Save as Example - 会自动填充当前请求 URL、方法、参数、Header;响应部分填入状态码(如
200)、Body 内容和 Content-Type(如application/json) - 注意:如果响应体含二进制内容(比如图片 Base64),Postman 不支持直接保存为 Example;超过
5 MB的响应也会被拒绝保存 - 保存后,该 Example 会挂在当前请求节点下,图标是小文档形状,点击即可在新标签页以“固定响应”方式重放
怎么手动添加自定义 Example(不依赖真实响应)
有些场景根本没法调通真实接口——比如后端还没写完,但前端要基于约定的字段开发;或者你想模拟 401、422 这类错误响应做 UI 容错。这时候就得手写 Example。
- 在集合中选中目标请求 → 点击右上角
⋯(More actions)→Add Example - 名称建议带状态标识,比如
success_200或error_401_unauthorized,避免后期混淆 - Request 部分可留空,或填入典型参数(如
id=123),方便别人理解触发条件 - Response 部分必须填
Status(如401)和Body;Content-Type 要匹配,比如 JSON 就选application/json,否则 Mock Server 返回时可能被浏览器当作纯文本处理
Example 和 Mock Server 是什么关系
很多人以为加了 Example 就自动有 Mock,其实不是:Example 只是“数据样本”,Mock Server 才是“服务实例”。两者必须显式绑定。
Postman 12.27.7 Windows x64 官方安装包,适用于 API 设计、调试、测试与协作。该系列包含 Enterprise 云端性能测试静态 IP 出口能力,以及接口规范标签管理改进,适合受限网络测试与规范资源组织场景。
- 创建 Mock Server 时,必须选择一个已有集合(Collection),它会扫描该集合里所有请求下的所有 Example
- 访问 Mock URL 时,Postman 会根据请求路径 + 方法 + 查询参数(部分匹配)去查找最接近的 Example;找不到就返回
404 - 关键限制:
POST请求的 Body 不参与匹配逻辑,Mock Server 只看 URL 和 method;所以别指望靠不同 JSON body 触发不同 Example - 如果你删掉了某个 Example,对应 Mock 响应会立刻失效,但 Mock Server 本身不会报错,只会默默 fallback 到
404
Example 编辑和删除的坑
Example 看似静态,但编辑行为有隐蔽副作用。
- 双击 Example 名称可改名,但改名不影响 Mock 匹配逻辑(匹配只看 URL 和 method)
- 编辑 Example 的 Response Body 后,必须点
Save,否则关闭标签页时修改丢失——这个 Save 按钮藏在右上角,很小,常被忽略 - 删除 Example 时,Postman 不二次确认;一旦删了,且没备份集合 JSON 文件,就真没了
- 导出集合时,默认包含所有 Example;但导入时,如果目标工作区已存在同名请求,Postman 会跳过 Example 导入(除非勾选
Merge examples选项)
Example 表面简单,实际是连接调试、协作、Mock 的枢纽点;最常出问题的不是“怎么加”,而是“加完没同步”“改了没保存”“删了不知道影响 Mock”。每次操作后,用 Mock URL 实测一次,比看界面更可靠。










