Postman Mock Server 如何让不同请求返回不同示例

如果一个 Postman Mock Server 里保存了多个 response example，却总是返回同一份数据，先别急着改响应体：Mock Server 默认主要根据请求方法、路径和查询参数选择最接近的 example，请求体和请求头并不会自动参与匹配。把差异放在查询参数上，或用明确的匹配头指定 example，就能让同一路径返回不同结果。

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

先把同一路径拆成可区分的 examples

打开 Postman 后，在左侧选择一个 HTTP collection，点击集合旁的加号创建请求。请求方法选 GET，URL 先填一个稳定的路径，例如 /orders。在 Params 标签中添加 state=paid，发送请求后，在响应区域选择保存为 example，并命名为 Paid。

接着保留同一请求路径，把 state 改成 cancelled，重新发送并保存为 Cancelled。两个 example 的响应内容可以分别写成订单列表和取消状态，但请求方法、路径要保持可比较；真正的差异先放在查询参数上。

从 collection 创建 Mock Server

1. 左侧点击 Add，选择 Mock Server。
2. 选择 Existing collection，绑定刚才保存 examples 的 collection。
3. 填写名称并创建，随后复制生成的 Mock URL。

这里最容易出错的是路径。假设 example 的请求路径是 /orders，调用时就不能只访问 Mock 根地址，也不能把 /orders 写成另一个大小写或层级。HTTP 方法同样要一致，否则匹配算法没有足够依据选择目标 example。

用查询参数让不同请求返回不同响应

在新的请求中，把复制的 Mock URL 和路径拼起来：

curl -G 'https://M1.mock.pstmn.io/orders' \
  --data-urlencode 'state=paid'
# 这里用查询参数选择 Paid example；M1 仅是文档中的 Mock URL 占位符

把 state=paid 改成 state=cancelled 再发送，应该分别命中两个 example。Postman 官方说明，匹配会比较请求路径和查询参数；如果没有完全相同的项，会从候选中选择最接近的响应。因此，参数名和值要写成你在 example 中保存的实际形式，不要只依赖响应体里出现的字段。

同一路径冲突时，用匹配头收紧选择范围

如果多个 examples 的方法、路径和查询参数都相同，默认匹配就可能无法稳定区分。这时可以在请求 Headers 中加入 x-mock-response-name，值填写唯一的 example 名称；也可以使用 x-mock-response-id 指定唯一 ID。名称必须保持唯一，否则按名称匹配仍可能得到非预期结果。

如果差异在请求体或业务请求头，不要把它们当成默认条件。进入 Services → Mock servers，选择目标服务并点击 Edit Configuration，在 Response Matching 中开启 Request body 或 Headers。请求体匹配时，example 和实际请求都要带相同的 Content-Type，例如 application/json；请求头匹配则填写需要比较的 header 名称，多个名称用逗号分隔。

排查时按“方法 → 路径 → 查询参数 → 显式匹配头 → 请求体/请求头配置”的顺序检查。若只想验证某个固定响应，优先使用唯一的 response name 或 ID；若要模拟真实业务分支，再把分支差异设计成查询参数或开启 body matching，维护成本会更低。

常见问题

为什么访问 Mock 根地址会返回错误？

因为根地址没有 example 的请求路径。把保存 example 时的路径追加到 Mock URL 后，并使用相同的 HTTP 方法。

只改响应体，能让 Mock Server 自动返回另一份 example 吗？

不能。默认匹配不把响应体当作请求条件；需要改请求路径、查询参数，或使用显式响应头。

请求体匹配已经打开，为什么还是匹配不到？

先检查 example 和实际请求是否都带了相同的 Content-Type。JSON 请求通常应统一为 application/json，并确认请求体内容确实与保存的 example 对应。