一个请求可存多个示例,无数量限制但单个响应体须小于5 MB,超限会静默丢弃;建议组合使用真实响应与自定义示例,并注意重放时的重定向、Content-Type及存储成功校验。

一个请求能存几个示例?没有硬限制,但有实际约束
Postman 允许一个请求绑定多个示例,数量上不限——你可以存 2 个、10 个甚至 50 个。但关键约束是:每个示例的响应体必须小于 5 MB。超过这个大小,保存时会失败,且不会给出明确提示,只静默丢弃响应内容。
常见踩坑点:
- 误把大文件下载响应(如导出 Excel 的
200响应)直接保存为示例,结果打开示例时响应体为空 - 在 mock server 场景下堆了太多高保真响应,导致集合体积膨胀、加载变慢
- 未清理过期示例(比如已废弃的
422错误格式),干扰新成员理解当前接口行为
保存响应为示例 vs 手动添加自定义示例,选哪个?
两者本质不同,不是“替代”而是“互补”:
-
保存响应为示例:基于真实调用快照,含原始状态码、响应头、完整 body,适合记录“线上实际返回了什么” -
添加自定义示例:完全可控,可模拟尚未实现的场景(如401、503)、构造边界数据(空数组、超长字符串)、或精简响应(只留关键字段用于文档)
建议组合使用:先用真实响应存 1–2 个典型示例(200、404),再手动补 1–3 个异常/边界示例。避免全靠手动造,也别全靠保存——后者无法覆盖未触发过的路径。
示例里改 URL 或参数,会影响原始请求吗?
不影响。示例中的请求部分(URL、Params、Headers、Body)是独立副本,修改它只改变该示例的“重放行为”,原始请求本身保持不变。
Postman 12.27.7 Windows x64 官方安装包,适用于 API 设计、调试、测试与协作。该系列包含 Enterprise 云端性能测试静态 IP 出口能力,以及接口规范标签管理改进,适合受限网络测试与规范资源组织场景。
这意味着:
- 你可以在示例里把
{{baseUrl}}换成硬编码地址,方便离线查看,原始请求仍用变量 - 可以给某个示例加一个临时
debug=true参数,其他示例和原始请求不受影响 - 但要注意:如果原始请求依赖预请求脚本(Pre-request Script)注入变量,而示例没开启“运行脚本”,那重放示例时可能拿不到预期值
尝试示例时看不到响应?检查这三点
点击示例后新标签页打开却显示空白或 loading 状态,大概率是以下原因:
- 该示例的响应状态码是
302或307,但 Postman 默认不自动跳转——需在示例编辑页勾选Follow redirects - 响应 Content-Type 是
application/octet-stream或未识别类型,Postman 不渲染 body;可在示例编辑页手动设为text/plain或application/json再试 - 示例保存时响应已超 5 MB,实际没存成功,此时 body 字段为空字符串,重放时发的是原始请求而非示例快照
真正容易被忽略的是第三点:Postman 不报错也不提醒,只默默丢掉超限响应。每次新增示例后,建议手动点开编辑页,确认 Response body 区域里有内容再保存。









