Postman mock server怎样用示例响应模拟接口

接口还没有开发完成，但前端已经需要一个稳定的返回结构时，可以先用 Postman mock server 顶上这个空档。它不是凭空生成接口，而是根据集合里保存的请求和 Example，匹配请求方法、路径以及必要的查询参数，再返回预先保存的响应。

官方地址：https://www.postman.com/

官方文档：https://learning.postman.com/docs/design-apis/mock-apis/tutorials/mock-with-examples

最稳妥的做法是先保存一个完整 Example，再从这个集合创建 Mock Server。请求 Mock URL 时，先保证路径和查询参数与 Example 对得上；如果服务设为私有，再补上 x-api-key 请求头。

先确定这次要模拟的接口

下面用一个查询宠物列表的接口作为示例。真实业务名称可以替换成自己的用户、订单或商品接口，但建议先选一个响应结构简单、能明确判断是否命中的 GET 请求。

1. 进入 Postman 工作区，左侧选择 Collections，点击添加集合，创建一个例如 Pet Store API 的集合。
2. 打开集合右侧的添加入口，选择 Add Request，方法选 GET。
3. 把请求地址填写为 https://postman-echo.com/get?test=123，点击 Send，再点击 Save 将请求保存到集合。

继续前要能看到三个状态：请求位于目标集合内、方法为 GET、请求已经有一个响应面板。如果只打开了临时请求而没有保存到集合，后面创建 Mock Server 时就没有可供匹配的 Example。

GET https://postman-echo.com/get?test=123
# 这里用固定查询参数制造一个容易匹配的请求样例
# 保存到集合后，Mock Server 才能把它和 Example 关联起来

保存一份可返回的 Example

Mock Server 真正返回的不是刚才那次请求的实时结果，而是请求下保存的示例响应。发送成功后，在响应区域点击 Save Response，必要时把示例命名为 List pets - success。

1. 确认响应面板中的状态码、响应头和 JSON 内容符合前端预期。
2. 点击响应区域的 Save Response，选择保存为 Example。
3. 打开生成的 Example，检查其中的请求方法、完整 URL、状态码和响应体。

验收标志是：请求下方或请求详情中出现一个可以再次打开的 Example，且它至少包含 200 状态码和一份 JSON 响应。若只保存了请求，没有保存响应，Mock Server 创建成功后也找不到可返回的数据。

{
  "items": [
    {"id": 101, "name": "Milo", "status": "available"}
  ],
  "next": null
}

上面的严格 JSON 只保留字段和值，字段应和调用方约定保持一致；说明文字放在代码块外，避免破坏 JSON 格式。

从集合创建 Mock Server

示例保存好后，回到左侧添加入口，选择 Mock Server，再选择从已有集合创建。创建面板里最重要的是集合、Mock 名称和访问范围。

1. 点击左侧添加入口，选择 Mock Server。
2. 选择 Existing collection，在 Collection 字段中选刚才保存请求的集合。
3. 填写 Mock 名称；如果要让本地前端或同事直接访问，可以选择公开服务。对需要访问控制的场景，选择私有服务。
4. 如果要模拟慢网络，可以设置固定延迟；本篇只验证示例响应，因此保持默认延迟即可。
5. 点击 Create Mock Server，创建后复制显示的 Mock URL。

创建完成的可见结果是：左侧 Mock Servers 列表出现新服务，详情中可以复制一条以 Mock 域名为基础的 URL。此时服务已经存在，但还要用正确的路径调用它，才能命中刚才的 Example。

把真实地址替换成 Mock URL

不要把原请求的完整路径一起覆盖掉。正确做法是只替换域名部分，保留 Example 中的路径和查询参数。例如原请求是 https://postman-echo.com/get?test=123，Mock 请求应保持 /get?test=123 不变。

1. 打开刚才的请求，把原地址的域名替换为复制到的 Mock URL。
2. 保留 /get 路径和 test=123 查询参数。
3. 点击 Send，在响应区域查看状态码和 JSON。

# 把 mock.example.test 替换成 Postman 创建后复制的 Mock 域名
curl "https://mock.example.test/get?test=123"
# 公共 Mock Server 通常可直接请求；私有服务需要额外发送 x-api-key
# curl 的输出只用于查看响应，不代表真实后端已经上线

成功时，响应面板应显示保存过的状态码和 JSON 结构，而不是依赖 postman-echo.com 的实时字段。需要强调的是，本文配图是帮助理解界面位置的原创说明图，不是实际请求的运行截图。

用路径和查询参数核对是否命中

当接口返回不符合预期时，先查匹配条件，不要马上重新创建服务。Postman 会使用请求方法、路径以及查询参数去选择集合中的 Example；同一个请求保存多个 Example 时，差异化的路径或查询参数有助于稳定选择。

如果调用私有 Mock Server，可以在 Headers 添加下面的请求头；密钥只放在本地环境变量或 Postman 环境中，不要把真实密钥写进集合共享内容。

# 私有 Mock Server 的访问头示意
x-api-key: 
# 真实密钥不要提交到代码仓库或公开集合
# 如果是公共 Mock Server，不要无条件添加不存在的密钥变量

把 Example 当成接口契约来维护

Mock Server 适合前后端并行、接口文档演示和测试数据准备，但它不会自动替代真实业务逻辑。后端字段发生变化时，应先更新集合里的 Example，再让调用方重新核对状态码、字段名和空值边界。

• 成功响应和典型失败响应分别保存，避免所有场景都返回 200。
• 需要区分结果时，为不同路径或查询参数准备明确的 Example。
• 共享集合前清理账号、Token、真实手机号和内部域名。
• 前端联调结束后，把 Mock URL 切回真实环境变量，避免测试请求误留在生产配置。

简单记忆这条链路即可：集合请求 → 保存 Example → 创建 Mock Server → 保留路径调用 → 核对匹配响应。只要 Example 存在且请求匹配，Postman mock server 就能在真实接口完成前提供稳定的返回结构。

相关问题

为什么创建了 Mock Server 却返回找不到示例？

通常是只保存了请求，没有保存 Example，或者调用时的路径、方法、查询参数与 Example 不一致。回到集合打开请求，确认存在可打开的 Example，再按原 URL 的路径部分调用。

公共和私有 Mock Server 怎么选？

需要跨网络快速联调时可以使用公共服务，但必须避免放入敏感数据；涉及内部接口或测试数据时优先使用私有服务，并在请求头中提供 API key。

修改 Example 后是否要重新创建 Mock Server？

一般不需要重新创建。保存修改后的 Example 后，再按同样的匹配条件发送请求即可；如果仍返回旧数据，先确认请求实际命中了哪个 Example。