接口自动化测试实战：Postman+Newman+Jenkins从入门到落地

前言

上一篇文章我们系统讲了接口测试的基础——HTTP协议、状态码、请求头、用例设计、F12抓包。但手工测接口有个痛点：每次发版都要把几十上百个接口全部重跑一遍，耗时耗力还容易漏。

本文是Web测试系列第七篇，手把手带你用Postman + Newman + Jenkins搭建一套可落地的接口自动化测试体系。从最基础的断言脚本写起，到动态token处理、数据驱动测试、HTML报告生成，最后集成到Jenkins实现一键回归。全程可复制、可执行，看完就能用。

📋 一、为什么要做接口自动化？

1.1 手工测试 vs 自动化测试

1.2 什么时候该做接口自动化？

1.3 接口自动化工具选型

📝本文选择 Postman + Newman，原因很简单：大多数手工测试工程师已经在用Postman做接口调试了，只需加上Tests脚本和Newman就能实现自动化，几乎零额外学习成本。

🔧 二、环境搭建（5分钟搞定）

2.1 安装Node.js

Newman依赖Node.js，先去官网下载安装。

# 安装完成后验证 node -v # 应显示 v18.x 或更高 npm -v # 应显示 9.x 或更高

2.2 安装Newman

bash

# 全局安装Newman npm install -g newman # 验证安装 newman -v # 应显示版本号

2.3 安装HTML报告插件（htmlextra）

bash

# 安装增强版HTML报告插件 npm install -g newman-reporter-htmlextra

装完这三样就完成了环境搭建，不超过5分钟。

📝 三、编写你的第一个接口测试脚本

3.1 从Collection开始

以一个用户管理系统为例，创建以下接口集合：

📁 用户管理系统 ├── 📁 登录模块 │ └── POST 登录 ├── 📁 用户管理 │ ├── GET 查询用户列表 │ ├── GET 查询用户详情 │ ├── POST 新增用户 │ ├── PUT 修改用户 │ └── DELETE 删除用户 └── 📁 退出模块 └── POST 退出登录

3.2 编写第一条Tests断言

以「POST 登录」接口为例，在Postman的Tests标签页写断言脚本：

javascript

// ========== 基础断言 ========== // 1. 校验状态码 pm.test("状态码为200", function () { pm.response.to.have.status(200); }); // 2. 校验响应时间 pm.test("响应时间小于2秒", function () { pm.expect(pm.response.responseTime).to.be.below(2000); }); // 3. 校验返回体是JSON格式 pm.test("返回格式为JSON", function () { pm.response.to.have.jsonBody(); }); // ========== 字段校验 ========== // 4. 校验code字段 pm.test("code等于200", function () { var jsonData = pm.response.json(); pm.expect(jsonData.code).to.eql(200); }); // 5. 校验message字段存在且不为空 pm.test("message字段不为空", function () { var jsonData = pm.response.json(); pm.expect(jsonData.message).to.not.be.empty; }); // 6. 校验data.token存在 pm.test("返回了token", function () { var jsonData = pm.response.json(); pm.expect(jsonData.data).to.have.property("token"); pm.expect(jsonData.data.token).to.be.a("string").and.not.empty; }); // ========== 提取变量供后续接口使用 ========== // 7. 将token存入环境变量 var jsonData = pm.response.json(); pm.environment.set("token", jsonData.data.token); // 8. 将用户ID存入环境变量 pm.environment.set("userId", jsonData.data.userId);

📝断言三步法：每个接口至少覆盖——①状态码 ②核心返回字段 ③关键业务值。

3.3 运行Collection验证

点击Postman左上角Collection名称旁的 ▶ 按钮 → Run → 勾选所有接口 → Run，查看执行结果。

所有用例都PASS才表示脚本编写正确。

🔗 四、接口关联：动态Token自动获取

接口自动化最大的痛点之一：token会过期，每次都要手动登录获取。Pre-request Script可以完美解决。

4.1 在Collection级别设置Pre-request Script

在Collection上右键 → Edit → Pre-request Script：

javascript

// 每次执行Collection时自动登录获取token // 判断token是否已存在且未过期 const tokenExpiry = pm.environment.get("token_expiry"); const now = Date.now(); if (!tokenExpiry || now > Number(tokenExpiry)) { console.log("Token不存在或已过期，正在自动登录..."); pm.sendRequest({ url: pm.environment.get("base_url") + "/api/user/login", method: "POST", header: { "Content-Type": "application/json" }, body: { mode: "raw", raw: JSON.stringify({ username: pm.environment.get("test_username"), password: pm.environment.get("test_password") }) } }, function (err, res) { if (err) { console.error("登录失败:", err); return; } var jsonData = res.json(); if (jsonData.code === 200) { pm.environment.set("token", jsonData.data.token); // 设置token过期时间（假设2小时后过期） pm.environment.set("token_expiry", String(now + 2 * 60 * 60 * 1000)); console.log("Token自动获取成功！"); } else { console.error("登录失败:", jsonData.message); } }); }

4.2 在接口中使用Token

在每个需要认证的接口Headers中设置：

📝{{token}}是Postman的变量引用语法，运行时自动替换为环境变量中的实际值。

4.3 变量作用域一览

📝推荐做法：测试环境URL、账号密码、token等放在Environment变量中，便于切换环境。

📊 五、数据驱动测试：用CSV批量跑数据

5.1 什么是数据驱动测试？

同一个接口，用不同的数据反复执行。例如注册接口，需要测试各种用户名、密码的组合——不用写多条用例，一条用例 + 一个CSV文件即可。

5.2 准备CSV数据文件

新建register_testdata.csv：

csv

username,password,email,expected_code,expected_msg normal_user,Pass1234,user1@test.com,201,注册成功 short,Pass1234,user2@test.com,422,用户名长度不足 toolongusername123456789,Pass1234,user3@test.com,422,用户名长度超限 ,,user4@test.com,422,用户名不能为空 normal_user2,weak,user5@test.com,422,密码强度不足 normal_user3,Pass1234,invalid_email,422,邮箱格式不正确 normal_user4,Pass1234,,422,邮箱不能为空

5.3 编写参数化Tests脚本

javascript

// 从CSV数据文件读取期望值 var expectedCode = parseInt(pm.iterationData.get("expected_code")); var expectedMsg = pm.iterationData.get("expected_msg"); // 校验状态码 pm.test("状态码为" + expectedCode, function () { pm.response.to.have.status(expectedCode); }); // 校验返回消息 pm.test("返回消息包含：" + expectedMsg, function () { var jsonData = pm.response.json(); pm.expect(jsonData.message).to.include(expectedMsg); }); // 如果是注册成功（201），额外校验返回字段 if (expectedCode === 201) { pm.test("注册成功返回用户ID", function () { var jsonData = pm.response.json(); pm.expect(jsonData.data).to.have.property("userId"); }); }

5.4 运行数据驱动测试

Postman Collection Runner → Select File → 选择CSV文件 → Run。

Postman会自动用CSV中每一行数据执行一次请求，结果中会显示每行的通过/失败状态。

📝数据驱动测试核心：

• CSV第一行是变量名（与pm.iterationData.get()中的名称对应）
• 每个变量一行，Postman自动遍历
• 可以混合正向和反向用例

5.4 运行数据驱动测试

Postman Collection Runner → Select File → 选择CSV文件 → Run。

Postman会自动用CSV中每一行数据执行一次请求，结果中会显示每行的通过/失败状态。

📝数据驱动测试核心：

• CSV第一行是变量名（与pm.iterationData.get()中的名称对应）
• 每个变量一行，Postman自动遍历
• 可以混合正向和反向用例

🔄 六、接口链式调用：增→查→改→删全流程

真实业务场景中，接口之间存在依赖关系。比如：新增用户 → 查询用户 → 修改用户 → 删除用户。

6.1 链式调用实现思路

POST 新增用户 → 提取返回的userId ↓ GET 查询用户详情 → 使用上一步的userId ↓ PUT 修改用户 → 使用上一步的userId ↓ DELETE 删除用户 → 使用上一步的userId ↓ GET 查询用户详情 → 验证已删除（返回404）

6.2 各接口Tests脚本

POST 新增用户：

javascript

pm.test("新增用户成功", function () { pm.response.to.have.status(201); var jsonData = pm.response.json(); // 将返回的userId存入环境变量，供后续接口使用 pm.environment.set("newUserId", jsonData.data.userId); console.log("新增用户ID:", jsonData.data.userId); });

GET 查询用户详情：

URL使用变量：GET {{base_url}}/api/user/{{newUserId}}

javascript

pm.test("查询到刚创建的用户", function () { pm.response.to.have.status(200); var jsonData = pm.response.json(); pm.expect(jsonData.data.userId).to.eql(pm.environment.get("newUserId")); });

PUT 修改用户：

javascript

pm.test("修改用户成功", function () { pm.response.to.have.status(200); var jsonData = pm.response.json(); pm.expect(jsonData.message).to.include("成功"); });

DELETE 删除用户：

javascript

pm.test("删除用户成功", function () { pm.response.to.have.status(200); });

GET 再次查询（验证已删除）：

javascript

pm.test("用户已被删除", function () { pm.response.to.have.status(404); });

📝链式调用的关键：

• 上游接口在Tests中通过pm.environment.set()提取关键数据
• 下游接口通过{{变量名}}引用
• 接口执行顺序按Collection中的排列顺序（可在Runner中调整）

🚀 七、Newman命令行执行与HTML报告

7.1 导出Collection和环境变量

1. Postman中Collection右键 → Export → 选择Collection v2.1格式 → 保存为user_api_collection.json
2. Postman右上角环境选择器 → Manage Environments → 导出 → 保存为test_env.json

7.2 Newman基础命令

bash

# 最基础的执行 newman run user_api_collection.json # 指定环境变量 newman run user_api_collection.json -e test_env.json # 指定数据文件 newman run user_api_collection.json -e test_env.json -d register_testdata.csv # 指定迭代次数 newman run user_api_collection.json -e test_env.json -n 3 # 生成HTML报告（htmlextra） newman run user_api_collection.json \ -e test_env.json \ -r htmlextra \ --reporter-htmlextra-title "用户管理系统-接口测试报告" \ --reporter-htmlextra-browserTitle "API Test Report"

7.3 常用参数速查

7.4 报告解读

执行后会在当前目录生成newman/文件夹，打开里面的HTML文件即可看到：

🤖 八、Jenkins集成：实现CI/CD自动化回归

8.1 Jenkins配置步骤

Step 1：安装必要插件

• NodeJS Plugin（提供Node环境）
• HTML Publisher Plugin（展示HTML报告）

Step 2：配置NodeJS环境

Jenkins → Manage Jenkins → Global Tool Configuration → NodeJS → 新增安装 → 选择Node版本

Step 3：创建自由风格任务

新建Item → Freestyle project → 输入任务名称

Step 4：配置定时构建

构建触发器 → Build periodically：

# 每天早上8点执行 H 8 * * * # 每4小时执行一次 H */4 * * * # 工作日每小时执行 H * * * 1-5

Step 5：配置构建步骤

添加构建步骤 → Execute shell（Linux）或 Execute Windows batch command（Windows）：

bash

# 安装依赖（首次需要） npm install -g newman newman-reporter-htmlextra # 执行接口自动化测试 newman run user_api_collection.json \ -e test_env.json \ -r cli,htmlextra,junit \ --reporter-htmlextra-title "用户管理系统-接口回归测试" \ --reporter-htmlextra-browserTitle "API Test" \ --reporter-junit-export junit-report.xml # 检查退出码，非0表示有用例失败 if [ $? -ne 0 ]; then echo "接口测试有失败用例，请检查！" exit 1 fi

Step 6：配置HTML报告展示

构建后操作 → Publish HTML reports：

Step 7：配置邮件通知

构建后操作 → Editable Email Notification，在构建失败时自动发送邮件。

8.2 Jenkins CI/CD流水线示意图

代码提交(Git Push) ↓ 触发Jenkins构建 ↓ 拉取最新代码 + 接口测试脚本 ↓ Newman执行接口自动化 ↓ 生成HTML报告 + JUnit报告 ↓ 判断结果 ├── 全部通过 → ✅ 构建成功 → 自动部署 └── 有失败 → ❌ 构建失败 → 发送邮件通知 → 阻止部署

📋 九、实战案例：电商下单流程接口自动化

9.1 接口链路

1. POST 登录 → 获取token 2. GET 搜索商品 → 获取商品ID 3. GET 商品详情 → 校验库存 4. POST 加入购物车 → 获取购物车项ID 5. POST 创建订单 → 获取订单ID 6. GET 查询订单 → 校验订单状态 7. POST 支付订单 → 模拟支付 8. GET 查询订单 → 校验状态变为"已支付"

9.2 完整Tests脚本

POST 登录：

javascript

pm.test("登录成功", function () { pm.response.to.have.status(200); var jsonData = pm.response.json(); pm.expect(jsonData.code).to.eql(200); pm.environment.set("token", jsonData.data.token); console.log("Token获取成功"); });

GET 搜索商品：

javascript

pm.test("搜索商品成功", function () { pm.response.to.have.status(200); var jsonData = pm.response.json(); pm.expect(jsonData.data.list).to.be.an("array").that.is.not.empty; // 取第一个商品的ID pm.environment.set("productId", jsonData.data.list[0].productId); console.log("商品ID:", jsonData.data.list[0].productId); });

GET 商品详情：

javascript

pm.test("商品详情查询成功", function () { pm.response.to.have.status(200); var jsonData = pm.response.json(); pm.expect(jsonData.data.stock).to.be.greaterThan(0); // 库存大于0 pm.environment.set("productPrice", jsonData.data.price); });

POST 加入购物车：

javascript

pm.test("加入购物车成功", function () { pm.response.to.have.status(200); var jsonData = pm.response.json(); pm.environment.set("cartItemId", jsonData.data.cartItemId); });

POST 创建订单：

javascript

pm.test("创建订单成功", function () { pm.response.to.have.status(201); var jsonData = pm.response.json(); pm.expect(jsonData.data.totalAmount).to.eql(pm.environment.get("productPrice")); pm.environment.set("orderId", jsonData.data.orderId); console.log("订单ID:", jsonData.data.orderId); });

GET 查询订单：

javascript

pm.test("订单状态为待支付", function () { pm.response.to.have.status(200); var jsonData = pm.response.json(); pm.expect(jsonData.data.status).to.eql("UNPAID"); });

POST 支付订单：

javascript

pm.test("支付成功", function () { pm.response.to.have.status(200); var jsonData = pm.response.json(); pm.expect(jsonData.message).to.include("成功"); });

GET 查询订单（再次查询验证状态变更）：

javascript

pm.test("订单状态变更为已支付", function () { pm.response.to.have.status(200); var jsonData = pm.response.json(); pm.expect(jsonData.data.status).to.eql("PAID"); });

9.3 执行命令

bash

newman run ecommerce_collection.json \ -e ecommerce_env.json \ -r htmlextra \ --reporter-htmlextra-title "电商下单流程-接口自动化测试"

⚠️ 十、常见问题与避坑指南

🧠 十一、记忆口诀

接口自动化五步走

断言先行定标准——先写Tests脚本，定义什么算通过 变量关联串流程——token、userId用变量串联 数据驱动提效率——CSV批量跑正向反向用例 命令行跑出报告——Newman一键执行生成HTML Jenkins定时全自动——CI/CD流水线解放双手

📝 写在最后

接口自动化测试不是一蹴而就的，建议分阶段推进：

从第一条断言脚本开始，一步一个脚印，你的接口自动化体系就会慢慢建立起来。

下一篇我们将进入性能测试入门领域，教你如何用JMeter做接口压力测试，敬请期待！

系列文章导航

1. [测试用例设计方法论：从等价类到因果图的实战指南]
2. [测试策略与测试计划制定：新项目如何规划测试]
3. [从需求到高质量用例：手把手教你拆解需求]
4. [Bug报告与缺陷管理规范：如何写出让开发无法拒绝的Bug单]
5. [APP专项测试实战：安装/卸载/弱网/兼容/中断/埋点全覆盖]
6. [Web端测试实战（含接口测试核心章节）]
7. ← 本文：接口自动化测试实战：Postman+Newman+Jenkins
8. 性能测试入门（即将更新）