如何使用 Postman 高效测试 API：从入门到实战的完全指南

2026-02-17 17:26:44 0条评论 6次阅读 0人点赞

在软件开发的生命周期中，API（应用程序接口）扮演着至关重要的角色。作为连接前端用户界面与后端逻辑的桥梁，API 的稳定性直接决定了整个应用程序的质量。然而，仅仅确保代码能够运行是不够的，我们需要一套系统化的方法来验证 API 的功能、可靠性、性能和安全性。这就是 API 测试的核心价值所在。

在这篇文章中，我们将深入探讨如何利用业界最受欢迎的工具之一——Postman，来进行全面的 API 测试。无论你是刚入行的后端工程师，还是需要调试接口的前端开发者，通过这篇文章，你将学会如何从零开始构建测试环境，编写自动化脚本，并掌握最佳实践，从而让你的 API 坚如磐石。

为什么选择 Postman？

在开始之前，让我们先统一一下认识。API 测试不仅仅是发送请求并查看返回值。它涉及到对 HTTP 协议的理解、对数据格式的校验以及对异常情况的处理。Postman 之所以成为开发者的“瑞士军刀”，是因为它将所有这些复杂的操作封装在一个直观的图形用户界面（GUI）中。

它不仅能处理简单的 GET 请求，还能处理复杂的身份验证、环境变量管理以及自动化测试脚本。最重要的是，它允许我们将一系列请求组织成“集合”，甚至可以将其集成到持续集成/持续部署（CI/CD）流程中，实现真正的 DevOps 自动化。

前置条件： 在开始跟随我们的教程操作之前，请确保你已经下载并安装了最新版本的 Postman 客户端。准备好你的开发环境，让我们一起动手吧。

Postman 基础与 HTTP 请求语法

Postman 的核心功能是模拟客户端（如浏览器或移动应用）向服务器发送 HTTP 请求。一个标准的 HTTP 请求包含几个关键部分：请求方法、URL、请求头和请求体。

#### 请求方法的语义

在 Postman 的下拉菜单中，你会看到多种 HTTP 方法，最常用的包括：

GET：用于从服务器获取数据。不应有副作用，是幂等的。
POST：用于向服务器提交新数据。通常会导致服务器状态的改变，比如创建一条新记录。
PUT：用于更新现有资源。也是幂等的，即无论执行多少次相同操作，结果都应一致。
DELETE：用于删除资源。

#### 理解请求结构

在发送请求前，我们需要了解基本的语法结构。最简化的请求语法如下：

例如：

GET https://api.example.com/users

但在实际应用中，我们很少只使用这么简单的结构。通常我们还需要添加 Headers（用于传递元数据，如身份验证 Token）和 Body（用于 POST 请求中的数据）。

实战演练：构建与测试图书馆 API

为了让你更直观地理解，我们将模拟一个图书馆管理系统的 API 测试过程。我们将一步步执行从创建工作区到编写自动化测试脚本的完整流程。

假设我们的 API 基础 URL 是：

https://library-api.postmanlabs.com

#### 步骤 1：创建一个专属工作区

作为一个专业的开发者，保持工作环境的整洁是高效工作的前提。我们不应该将测试请求混杂在默认的空白空间中。

打开 Postman，启动后的界面直观且友好。
点击左上角的 Workspaces，然后选择 Create Workspace（创建工作区）。
给它起一个有意义的名字，例如 Library API Testing。
你可以选择将工作区设为个人或团队可见，这里我们保持默认，点击 Create。

现在，你拥有了一个干净的画布，可以专注于当前的测试任务。

#### 步骤 2：初始化一个新的请求

接下来，让我们创建第一个请求。我们的目标是向图书馆添加一本新书。根据 RESTful 规范，这通常是一个 POST 请求。

点击左上角的 New 按钮，在弹出的菜单中选择 Request（请求）。
系统会提示你保存这个请求，我们可以将其命名为 Add New Book，并选择刚才创建的 Library API Testing 集合来保存它。
在请求构建器中，从下拉菜单中选择 POST。
在地址栏输入我们的端点 URL：

https://library-api.postmanlabs.com/books

#### 步骤 3：配置请求体

POST 请求通常需要携带数据。现代 API 大多采用 JSON（JavaScript Object Notation）格式进行数据交换。

点击 Body (正文) 选项卡。你会看到多种格式选项，如 form-data、x-www-form-urlencoded 等。
选择 raw (原始) 选项，这允许我们输入纯文本格式的数据。
在右侧的下拉菜单中，确保选择 JSON。这一步非常关键，因为它会自动帮我们设置正确的 Content-Type 请求头。
输入以下 JSON 数据作为我们要添加的书籍信息：

{
    "title": "To Kill a Mockingbird New",
    "author": "Harper Lee",
    "genre": "Fiction",
    "yearPublished": 1960
}

> 专业见解：注意 JSON 的键值对必须使用双引号。如果你使用了单引号，即使语法看起来没问题，服务器解析时也会报错，这是新手常犯的错误。

#### 步骤 4：发送请求与初步验证

现在，万事俱备，只欠东风。

点击蓝色的 Send (发送) 按钮。
观察下方的 Response (响应) 窗口。如果一切正常，你会看到状态码 201 Created。这表示服务器成功接收了请求并创建了资源。
在响应体中，你应该能看到刚才提交的书籍信息，甚至可能包含服务器自动生成的 ID。

!image-(1)-(1).png)

#### 步骤 5：深入探究 – JavaScript Fetch 实现

虽然我们使用的是 Postman 界面，但了解其背后的代码原理对于调试非常有帮助。在 Postman 的右侧边栏，有一个代码生成功能（通常是一个图标）。点击它，你可以看到该请求对应的多种语言代码，例如 JavaScript (Fetch)。

如果我们手动编写这段代码，它大概是这样的：

// 1. 定义请求头，设置内容类型为 JSON
const myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");
// 某些 API 可能还需要 Key，这里作为示例
myHeaders.append("api-key", "postmanrulz");

// 2. 准备要发送的数据体，需转换为 JSON 字符串
const raw = JSON.stringify({
    "title": "To Kill a Mockingbird New",
    "author": "Harper Lee",
    "genre": "fiction",
    "yearPublished": 1960
});

// 3. 配置请求选项
const requestOptions = {
    method: "POST",
    headers: myHeaders,
    body: raw,
    redirect: "follow" // 处理重定向
};

// 4. 发起 Fetch 请求
fetch("https://library-api.postmanlabs.com/books", requestOptions)
    .then((response) => response.text()) // 将响应转换为文本
    .then((result) => console.log(result)) // 打印结果
    .catch((error) => console.error(error)); // 捕获错误

这段代码展示了在浏览器或 Node.js 环境中，如果不使用 Postman，我们需要如何处理异步请求和 Promise。这有助于我们理解 HTTP 通信的本质。

进阶：编写自动化测试脚本

仅仅靠肉眼看“状态码是 201”是远远不够的。我们需要代码来帮我们自动验证结果。Postman 允许我们在请求发送前或接收后执行 JavaScript 脚本，这被称为“Pre-request Script”和“Tests”。

#### 为什么要编写测试脚本？

想象一下，如果有 100 个接口，每次修改代码后你都要手动点击并发送 100 次请求，还要肉眼看结果吗？编写测试脚本可以让你一键运行整个测试套件，几秒钟内完成所有验证。

#### 提取响应数据

在我们的例子中，服务器返回了新创建的书籍信息，包含一个唯一的 INLINECODE4e307575。在后续的操作中（比如删除这本书或更新这本书），我们需要用到这个 INLINECODE19b59c19。我们可以编写一个测试脚本来“捕获”这个 ID。

切换到请求编辑器下方的 Tests (测试) 选项卡。
输入以下 JavaScript 代码：

// 1. 解析响应体 JSON
const responseJson = pm.response.json();

// 2. 提取 ID 字段
// 注意：这里假设 API 返回的结构是 { id: 123, ... }
const bookId = responseJson.id;

// 3. 检查 ID 是否存在
pm.test("Book ID should exist", () => {
    pm.expect(bookId).to.exist;
});

// 4. 将 ID 存储为环境变量或集合变量
// 这样在同一个集合的下一个请求中，我们就可以用 {{id}} 来引用它
pm.collectionVariables.set("id", bookId);

点击 Send 再次发送请求。
你会看到 Test Results (测试结果) 标签页中出现绿色的 Passed。

!Screenshot-(190)-(1)-(1)-(1).png)

现在，打开侧边栏的 Variables (变量) 部分或 Collection Variables，你会看到 id 变量已经被赋值了。这就是数据驱动测试的基础：让后续请求自动使用前一个请求产生的数据。

全面解析：常见 HTTP 状态码

作为 API 测试人员，你必须对 HTTP 状态码了如指掌。它们是服务器与客户端沟通的语言。下表列出了我们在测试中最常遇到的状态码及其含义。

状态码

类型

含义与应用场景 —

—

— 200

Success

OK。请求成功。常见于 GET 请求成功获取数据。 201

Success

Created。资源已创建。这是 POST 请求成功后的标准返回码。 204

Success

No Content。无内容。通常用于 DELETE 请求或 PUT 请求，表示操作成功但不需要返回数据体。 400

Client Error

Bad Request。错误请求。客户端发送的数据格式错误（例如 JSON 格式不正确）或参数缺失。 401

Client Error

Unauthorized。未授权。通常意味着身份验证失败，Token 过期或缺失。 403

Client Error

Forbidden。禁止访问。服务器理解了请求，但拒绝执行。通常涉及权限问题（如普通用户试图访问管理员接口）。 404

Client Error

Not Found。未找到。请求的资源不存在。这是最常见的错误之一，可能是 URL 拼写错误或资源已被删除。 500

Server Error

Internal Server Error。内部服务器错误。这是一个笼统的错误，表示服务器端发生了意外情况（如代码崩溃、数据库连接失败）。

深入应用：更多测试场景与最佳实践

掌握了基础操作后，让我们通过几个具体的场景，来看看如何在 Postman 中应对更复杂的情况。

#### 场景 1：验证响应数据的结构和类型

仅仅验证状态码是不够的，我们需要确保返回的数据结构符合预期。Postman 内置了 Chai Assertion Library，这使得断言变得非常简单。

示例代码：

// 在 Tests 选项卡中编写
pm.test("Status code is 201", function () {
    pm.response.to.have.status(201);
});

// 验证响应时间是否在 200ms 以内（性能测试的雏形）
pm.test("Response time is less than 200ms", function () {
    pm.expect(pm.response.responseTime).to.be.below(200);
});

// 验证 JSON 结构
pm.test("Book has correct structure", function () {
    var jsonData = pm.response.json();
    pm.expect(jsonData).to.have.property(‘title‘);
    pm.expect(jsonData).to.have.property(‘author‘);
    pm.expect(jsonData.title).to.be.a(‘string‘); // 确保标题是字符串类型
    pm.expect(jsonData.yearPublished).to.be.a(‘number‘); // 确保年份是数字类型
});

实用见解：pm.response.responseTime 是一个非常有用的属性。在持续集成中，你可以设置一个阈值，如果 API 响应变慢，测试就会失败。这能帮助你及早发现性能瓶颈。

#### 场景 2：处理动态数据与环境变量

在开发过程中，我们通常有多个环境：开发环境、测试环境和生产环境。每个环境的 API URL 是不同的。我们不想每次切换环境时都去修改代码。

点击右上角的齿轮图标 Manage Environments (管理环境)。
点击 Add，创建一个名为 Development 的环境。
添加一个变量 INLINECODE8e2562ba，值为 INLINECODE5388e628。
再创建一个 Production 环境，base_url 设为实际生产地址。
在请求 URL 中，将原来的地址替换为 {{base_url}}/books。

现在，你只需要在右上角的下拉菜单中切换环境，所有的请求都会自动指向新的地址，无需修改任何代码。

#### 场景 3：身份验证测试

大多数安全的 API 都需要某种形式的身份验证。最常见的是 Bearer Token。

流程：

登录请求：首先发送一个 POST 请求到 /login，携带用户名和密码。
提取 Token：在登录请求的 Tests 标签页中，提取 Token 并存入环境变量。

var jsonData = pm.response.json();
// 假设返回结构是 { "token": "xyz..." }
pm.environment.set("auth_token", jsonData.token);

使用 Token：在后续受保护的请求中，切换到 Headers (请求头) 选项卡，添加一个 Key 为 INLINECODEb5ff09d9，Value 为 INLINECODE2e7fff3b。

现在，每一次需要权限的请求都会自动带上登录时获取的最新 Token，实现了自动化的鉴权流程。

常见错误及解决方案

在使用 Postman 进行测试时，你可能会遇到一些棘手的问题。这里总结了一些常见的坑及其解决方案。

Error: Invalid JSON：

* 原因：请求体中使用了单引号而非双引号，或者尾随逗号（JSON 不允许最后一个属性后有逗号）。

* 解决：使用 JSON 验证器检查格式，或使用在线工具格式化你的 JSON。

Error: Could not get any response：

* 原因：可能是网络问题，或者 URL 错误，或者是服务器拒绝了连接（CORS 问题通常只在浏览器中出现，Postman 通常不受影响，但如果是 SSL 证书错误则可能发生）。

* 解决：检查 URL 拼写，尝试在浏览器中访问该地址。如果是 SSL 问题，可以在 Postman Settings 中关闭 SSL certificate verification（仅用于测试环境）。

Tests 失败：Cannot read property ‘id‘ of undefined：

* 原因：响应不是预期的 JSON 格式，或者接口返回了错误（如 500 Error），导致解析失败。

* 解决：先在 Body 视图中检查实际返回的原始文本是什么，确认接口本身工作正常后再编写测试脚本。

总结与后续步骤

通过这篇文章，我们从最基础的 GET 请求开始，逐步深入到了 POST 数据、环境变量管理以及自动化测试脚本的编写。我们学习了如何通过 Tests 选项卡将手动的点击操作转化为可执行的自动化代码，这对于提高软件交付质量和效率至关重要。

关键要点：

不要只看 Body，要看 Tests：自动化测试是回归测试的基石。
善用变量：利用环境变量和集合变量来隔离环境和串联业务逻辑。
深入理解状态码：它们是诊断 API 问题的第一手线索。

下一步建议：

为了继续提升你的技能，我们建议你探索 Postman 的 Collection Runner（集合运行器），它可以让你按顺序运行整个文件夹中的请求，甚至进行数据驱动测试（例如从 CSV 文件读取成百上千条测试数据）。此外，不妨尝试将你的测试集合集成到 Jenkins 或 GitHub Actions 中，实现真正的持续集成测试流程。

现在，打开你的 Postman，开始为你自己的 API 编写第一个自动化测试用例吧！

投稿给我们	如何建站？
vps是什么？	如何安装宝塔？
如何通过博客赚钱？	便宜wordpress托管方案
免费wordpress主题	这些都是免费方案

豆丁博客

如何使用 Postman 高效测试 API：从入门到实战的完全指南

为什么选择 Postman？

Postman 基础与 HTTP 请求语法

实战演练：构建与测试图书馆 API

进阶：编写自动化测试脚本

全面解析：常见 HTTP 状态码

深入应用：更多测试场景与最佳实践

常见错误及解决方案

总结与后续步骤

相关文章美国1G带宽/1T流量高速vps $17.99/年