CentOS下使用 Postman Mock 服务
一 环境准备
- 在 CentOS 上安装 Postman(Linux 桌面环境或带 GUI 的发行版):
- 从官网下载 Postman-linux-x64-.tar.gz;
- 解压:
tar -xvf Postman-linux-x64-<version>.tar.gz;
- 移动到系统目录:
sudo mv Postman /opt;
- 建立软链:
sudo ln -s /opt/Postman/Postman /usr/local/bin/postman;
- 启动:
postman(或在应用菜单中打开)。以上步骤完成后即可在 CentOS 桌面中使用 Postman 创建与使用 Mock 服务。
二 创建 Mock 服务的两种方式
- 方式A 从零创建
- 在 Postman 中点击 New > Mock Server,选择请求方法(如 GET/POST)、路径(如 /users)、状态码与响应体;
- 选择 Public(公有)或 Private(私有)类型;私有需使用 x-api-key 请求头;
- 完成后复制 Mock Server URL,后续请求使用“Mock URL + 路径”访问。
- 方式B 基于集合与示例创建(推荐)
- 先向任意接口(如 https://postman-echo.com/get?test=123)发送请求;
- 将该请求 Save to Collection,并把响应 Save as Example(示例需包含期望的 URL、Method、Status Code、Body);
- 在集合侧栏进入 Mocks > Create a mock server,选择集合与示例,生成 Mock URL;
- 访问时在请求头按需添加 x-api-key(私有 Mock 必填)。以上流程确保 Mock 按示例精确返回预期结果。
三 在 CentOS 终端用 curl 验证
- 公有 Mock(无需密钥)
curl -X GET 'https://<mock-id>.mock.pstmn.io/users'
- 私有 Mock(需密钥)
curl -X GET 'https://<mock-id>.mock.pstmn.io/users' \
-H 'x-api-key: <你的Postman API Key>'
- 指定返回状态码(示例)
curl -X GET 'https://<mock-id>.mock.pstmn.io/users' \
-H 'x-mock-response-code: 404' \
-H 'x-api-key: <你的Postman API Key>'
- 带查询参数的匹配示例
curl -X GET 'https://<mock-id>.mock.pstmn.io/users?role=admin&active=true' \
-H 'x-api-key: <你的Postman API Key>'
说明:Mock 服务会依据保存的示例对 路径、方法、查询参数、状态码 进行匹配并返回对应响应;私有 Mock 必须在请求头中加入 x-api-key。
四 常见问题与排查
- 返回 404 或无匹配:检查请求是否使用了正确的 Mock URL + 路径,以及示例中的 Method/Status 是否与请求一致;同一路径可保存多个示例以区分不同响应。
- 私有 Mock 报 401/403:确认请求头包含 x-api-key,且密钥有效;如忘记密钥,需在 Postman 的 Postman API Keys 页面重新生成并更新到请求头。
- 响应延时:在创建 Mock 时可设置 Add a delay(如模拟 2G/3G 或自定义毫秒),用于前端/联调的时序测试。
- 动态数据:在示例响应体中使用 Postman 动态变量(如 {{$randomFullName}}、{{$randomUserName}}、{{$timestamp}})生成随机数据,便于丰富测试场景。
- 调用额度:Postman 账户每月有 免费 Mock 调用次数限制,可在 Postman API 或账户使用页面查看与规划用量。