Postman：学习手册 / 全景梳理与深度分析

Postman 已从 2013 年一个简单的 REST 客户端，发展成为全球超过 4000 万开发者使用的 API 开发协作平台。它覆盖了从设计、调试、测试到文档、监控的 API 全生命周期，成为连接前后端团队的“技术契约枢纽”。

一、产品概述与核心价值

1.1 Postman 是什么？

Postman 是一个功能强大的 API 开发和测试工具，被广泛应用于软件开发的各个阶段。它提供完整的图形化界面，让开发者可以轻松构建、发送和分析 HTTP/HTTPS、WebSocket、GraphQL 等协议的请求。

1.2 核心能力矩阵

企业真实标准：给你一套项目接口文档 + 测试环境，能在 1 天内把所有接口录入 Postman、做好环境变量和 token 自动关联、写好断言、批量跑一遍并出报告——达到这个水平，完全满足企业接口测试岗位的要求。

二、核心功能全景速查

三、变量体系（自动化核心）

3.1 五级作用域与优先级

Postman 的变量系统是其自动化能力的核心骨架，优先级遵循就近原则：数据变量 > 环境变量 > 集合变量 > 全局变量 > 内置变量。

3.2 使用示例

// 环境变量：定义 base_url = https://api.dev.example.com
// 请求 URL 中使用 {{base_url}}/users

// 在 Pre-request Script 中动态设置变量
const timestamp = new Date().getTime();
pm.environment.set("timestamp", timestamp);

// 在 Tests 脚本中提取响应并存入变量
const jsonData = pm.response.json();
pm.globals.set("access_token", jsonData.data.token);

四、请求生命周期与脚本自动化

4.1 请求生命周期

4.2 Pre-request Script（预请求脚本）

在请求发送前执行，常用于：

4.3 Tests（测试断言脚本）

在收到响应后执行，基于 pm 对象和 Chai 断言库：

基础断言：

// 状态码断言
pm.test("状态码为200", function () {
    pm.response.to.have.status(200);
});

// 响应时间断言
pm.test("响应时间小于200ms", function () {
    pm.expect(pm.response.responseTime).to.be.below(200);
});

// 业务码断言
pm.test("业务码为0", function () {
    const jsonData = pm.response.json();
    pm.expect(jsonData.code).to.eql(0);
});

// 字段存在性断言
pm.test("响应包含user_id", function () {
    const jsonData = pm.response.json();
    pm.expect(jsonData.data).to.have.property("user_id");
});

接口关联（JSON 提取器）：

// 登录接口：提取 token 并存入全局变量
const jsonData = pm.response.json();
pm.globals.set("access_token", jsonData.data.token);
pm.globals.set("user_id", jsonData.data.user_id);

// 后续接口：使用 {{access_token}} 或 {{user_id}}

动态参数断言：

// 创建接口：使用动态时间戳作为参数
const times = Date.now();
pm.globals.set("times", times);

// 断言响应中包含该动态值
pm.test("检查响应中包含标签名", function () {
    pm.expect(pm.response.text()).to.include("标签名" + times);
});

五、快捷操作速查表

5.1 通用操作

5.2 请求与响应

5.3 视图与窗口

如需修改快捷键，路径：File > Settings > Keyboard Shortcuts

六、Mock Server 与并行开发

Postman 的 Mock Server 是前后端并行开发的利器，前端可针对模拟接口先行开发，后端再实现真实接口。

6.1 创建 Mock Server 步骤

1. 基于已有 Collection 创建 Mock

2. 为每个端点定义示例响应（状态码 + 响应体）

3. 获取 Mock URL（如 https://{{mock_id}}.pstmn.io）

4. 前端针对 Mock URL 进行开发

5. 后端实现真实接口后，替换 base_url 环境变量即可无缝切换

6.2 Mock 响应模板示例

{
  "request": {
    "method": "GET",
    "url": "/users/:id"
  },
  "response": {
    "status": 200,
    "body": "{\"id\": \"{{id}}\", \"name\": \"Mock User\", \"email\": \"mock@example.com\"}"
  }
}

七、Newman 与 CI/CD 集成

Newman 是 Postman 的命令行工具，支持将集合测试集成到 CI/CD 流水线。

7.1 基础命令

# 安装 Newman
npm install -g newman

# 运行集合（带环境变量）
newman run collection.json -e environment.json

# 数据驱动测试
newman run collection.json -e environment.json -d data.csv

# 生成 HTML 报告
newman run collection.json --reporters html --reporter-html-export ./report.html

7.2 GitHub Actions 集成示例

- name: Run Postman tests
  run: |
    npm install -g newman
    newman run collection.json --reporters jest --reporter-jest-output ./report.xml

八、常见问题与最佳实践

8.1 面试必备 5 项核心能力

8.2 最佳实践建议

九、功能全景速查表

Postman 已从单纯的 API 客户端演变为完整的 API 开发协作平台，覆盖了从单个请求调试到自动化测试、Mock、文档、监控的全链路需求。掌握其核心功能，意味着能够在现代前后端分离架构与微服务治理体系中，高效完成日常接口验证、主导 API 治理体系建设，推动组织向标准化、自动化、可观测化的高质量交付范式跃迁。