Postman Mock Server教程：从零搭建模拟API的完整指南

2026-02-16 技术文章

在前后端并行开发中，后端接口尚未就绪往往成为前端开发的瓶颈。Postman Mock Server 提供了一种轻量、高效的解决方案——无需编写任何服务端代码，即可快速创建模拟API并返回预设响应数据。这篇 Postman Mock Server 教程面向新手用户，从基本概念讲起，手把手演示如何在 Postman 中创建和配置 Mock Server，涵盖具体使用场景与常见问题排查，帮助你在几分钟内跑通第一个模拟接口，真正实现前后端解耦开发。

什么是 Mock Server，为什么你需要它

Mock Server 直译为"模拟服务器"，核心作用是在真实后端接口不可用时，返回预先定义好的假数据，让前端或测试流程不被阻塞。

一个典型场景：团队刚完成接口文档评审，后端预计两周后交付，而前端需要立即开始页面联调。这时如果干等接口，整个迭代周期就会被拉长。Postman Mock Server 正是为解决这类问题而生——它基于你在 Postman 中已有的 Collection 和 Example（示例响应），自动生成一个可访问的 HTTPS 端点。前端只需将请求地址指向这个端点，就能拿到约定好的 JSON 数据，开发节奏完全不受后端进度影响。

除了前后端协作，Mock Server 在以下场景同样实用：

- 第三方API有调用频率限制（如每分钟60次），用 Mock 替代可避免触发限流 - 编写自动化测试时，需要稳定、可控的响应数据，而非依赖真实服务的不确定性 - 向客户或产品经理演示原型，不必部署完整后端

Postman 从 v7 版本开始大幅优化了 Mock Server 功能，当前最新的 Postman v11（2024年发布）中，免费用户每月可使用 1000 次 Mock Server 调用，付费团队则无此限制。

手把手创建你的第一个 Mock Server

整个过程不超过五分钟，以下是具体步骤：

第一步，打开 Postman 客户端，进入左侧的 Collections 面板，点击「+」新建一个 Collection，命名为 `User API Mock`。

第二步，在该 Collection 下新建一个 GET 请求，路径填写 `/api/users`。点击请求面板右上角的「Add Example」，在 Example 中设置响应状态码为 `200`，Body 选择 JSON 格式，填入以下内容：

```json { "code": 0, "data": [ { "id": 1, "name": "张三", "email": "[email protected]" }, { "id": 2, "name": "李四", "email": "[email protected]" } ] } ```

保存这个 Example——它就是 Mock Server 返回数据的依据。

第三步，点击 Collection 右侧的「...」菜单，选择「Mock collection」。在弹出的配置面板中，为 Mock Server 命名（如 `user-mock`），其余选项保持默认，点击「Create Mock Server」。

创建完成后，Postman 会生成一个类似 `https://xxxxxxxx.mock.pstmn.io` 的地址。复制这个地址，拼接上请求路径，在浏览器中访问 `https://xxxxxxxx.mock.pstmn.io/api/users`，你会看到刚才定义的 JSON 数据原样返回。

一个关键细节：Mock Server 通过匹配请求方法（GET/POST等）、路径和请求参数来决定返回哪个 Example。如果同一个请求下有多个 Example，可以通过请求头 `x-mock-response-code` 指定返回特定状态码的 Example，比如设置为 `404` 就能模拟资源不存在的场景。

两个实战场景：让 Mock Server 真正派上用场

场景一：模拟分页接口，支持不同参数返回不同数据。

在 `/api/users` 请求下创建两个 Example。第一个 Example 的请求参数设为 `page=1&size=10`，响应返回第一页数据；第二个 Example 参数设为 `page=2&size=10`，响应返回第二页数据。Mock Server 会根据实际请求中的 query 参数自动匹配对应的 Example。前端在开发分页组件时，切换页码就能拿到不同的模拟数据，无需任何额外配置。

场景二：模拟错误响应，测试前端异常处理逻辑。

为同一个接口再添加一个 Example，状态码设为 `500`，Body 填写：

```json { "code": -1, "message": "Internal Server Error" } ```

前端发起请求时，在 Headers 中加入 `x-mock-response-code: 500`，Mock Server 就会返回这个 500 响应。这样可以直接验证前端的错误提示、重试机制是否正常工作，而不必等后端真的出故障。

常见问题排查与配置技巧

问题一：请求 Mock Server 返回了「Mockoon could not find a matching response」或空响应。

这通常是路径不匹配导致的。检查以下几点：请求方法是否一致（GET 和 POST 不能混用）；URL 路径是否与 Example 中定义的完全一致（注意开头的 `/`）；如果设置了 query 参数匹配，确认参数名和值没有拼写错误。Postman Mock Server 的匹配规则是精确优先——有参数匹配的 Example 优先级高于无参数的。

问题二：Mock Server 返回 `401 Unauthorized`。

创建 Mock Server 时，默认勾选了「Make this mock server private」。私有 Mock 需要在请求头中添加 `x-api-key`，值为你的 Postman API Key（在 Postman 账户设置 > API Keys 中生成）。如果只是本地开发调试，可以在创建时取消勾选，将 Mock 设为公开访问。

一个实用技巧：在 Postman 的 Environment 中创建一个变量 `base_url`，开发阶段将其值设为 Mock Server 地址，联调阶段切换为真实后端地址。Collection 中所有请求使用 `{{base_url}}/api/users` 的写法，切换环境时无需逐个修改请求，一键完成 Mock 到真实接口的迁移。

总结

Postman Mock Server 的核心价值在于用最低成本消除接口依赖。从创建 Collection、定义 Example 到生成 Mock 端点，整个流程在 Postman 客户端内闭环完成，不需要额外安装任何工具。如果你还没有安装 Postman，可以前往 Postman 官网下载最新版本，免费账户即可体验 Mock Server 的全部核心功能。现在就动手创建你的第一个 Mock Server，让前后端并行开发真正跑起来。