JMeter 性能测试教程

JMeter 性能测试教程

▍ 从零开始学习 Apache JMeter：安装、编写测试脚本、参数化、断言、关联、压力测试与报告生成。

▍ 本仓库附带一个可直接运行的示例测试计划：`examples/demo-api.jmx`

1. 什么是 JMeter

Apache JMeter 是 Apache 基金会出品的一款开源的、基于 Java 的压力测试工具。它原本用于 Web 应用性能测试，后来扩展为支持多种协议：

|----------------------|---------------|
| 协议 | 用途 |
| 协议 | 用途 |
| HTTP / HTTPS | Web 接口、网页性能测试 |
| FTP | 文件上传下载 |
| JDBC | 数据库性能测试 |
| JMS | 消息队列 |
| TCP / UDP | 自定义协议 |
| WebSocket / gRPC（插件） | 现代应用 |

JMeter 能做什么：

• 模拟成百上千的并发用户
• 对接口做负载 / 压力 / 稳定性测试
• 用断言校验响应是否正确
• 参数化与关联，模拟真实业务场景
• 生成聚合报告与 HTML 图表报告

JMeter 不是浏览器的替代品：它不执行 JS / CSS 渲染（除非使用 Selenium / WebDriver 插件）。做纯接口性能测试它是最佳选择之一。

2. 安装与启动

2.1 环境要求

• JDK 8+（JMeter 5.x 建议 JDK 8~11，JMeter 5.5 之后需 JDK 8+，部分新版本需 11+）
• 不需要安装 Tomcat 等容器，JMeter 是独立程序

2.2 下载

官方下载页：<https://jmeter.apache.org/download_jmeter.cgi\>

• 选择 apache-jmeter-x.x.zip（Windows）或 .tgz（Linux/macOS）
• 解压即可，无需安装

2.3 启动

进入解压后的 bin 目录

cd apache-jmeter-5.6.3/bin

Windows

jmeter.bat

Linux / macOS（需要执行权限）

./jmeter

▍ 提示：jmeter.bat 打开的是 GUI（图形界面）。性能测试时务必使用命令行模式（见 第 13 节），GUI 只用于编写和调试脚本。

2.4 界面速览

图 1 JMeter 主界面：菜单栏、工具栏、左侧测试计划树与右侧配置面板（整棵树已展开）

启动后默认打开测试计划编辑器。常用区域：

• 左侧树：测试计划结构（Test Plan 根节点、线程组、采样器等）
• 右侧面板：选中节点的配置区域
• 菜单栏：File / Edit / Run / Options 等

3. 核心概念

JMeter 的一切都是建立在下面的树形结构上：

Test Plan（测试计划）

└── Thread Group（线程组）

├── Config Element（配置元件）：如 HTTP 请求默认值、CSV 数据

├── Sampler（采样器）：如 HTTP 请求、JDBC 请求

├── Logic Controller（逻辑控制器）：循环、条件、随机等

├── Timer（定时器）：控制请求间隔

├── Assertion（断言）：校验结果

└── Listener（监听器）：查看/保存结果

|----------------------|---------------------------------------------------------|
| 概念 | 说明 |
| 概念 | 说明 |
| Test Plan | 整个测试的根节点，可配置全局变量、线程组执行策略 |
| Thread Group | 一组虚拟用户。线程数 = 并发用户数，Ramp-Up 表示多久启动完所有线程 |
| Sampler | 真正发起请求的组件，如 HTTP Request |
| Config Element | 提供默认值 / 数据源，如 HTTP Request Defaults、CSV Data Set Config |
| Logic Controller | 控制采样器的执行顺序和次数，如 Loop Controller、If Controller |
| Timer | 控制请求之间的间隔，模拟用户思考时间 |
| Assertion | 校验响应是否符合预期，失败则标记该请求为错误 |
| Listener | 收集并展示结果，如 View Results Tree、Aggregate Report |

▍ 执行顺序：配置元件 → 前置处理器 → 定时器 → 采样器 → 断言 → 后置处理器 → 监听器（同一作用域内按此顺序执行）。

4. 第一个测试计划

下面创建一个访问 https://httpbin.org/get 的最小测试计划。

4.1 新建并保存

1. 打开 JMeter，测试计划会自动创建，命名为 Test Plan
2. 点击 File → Save As，保存为 first-test.jmx

4.2 添加线程组

图 2 线程组面板：设置线程数、Ramp-Up 时间与循环次数

1. 右键 Test Plan → Add → Threads (Users) → Thread Group
2. 配置：

• 线程数（Number of Threads）：10
• Ramp-Up 时间（秒）：5
• 循环次数（Loop Count）：1

4.3 添加 HTTP 请求

1. 右键线程组 → Add → Sampler → HTTP Request
2. 配置：

• 协议：https
• 服务器名称：httpbin.org
• 方法：GET
• 路径：/get

4.4 添加监听器

1. 右键线程组 → Add → Listener → View Results Tree
2. 右键线程组 → Add → Listener → Summary Report

4.5 运行

点击工具栏绿色 启动 按钮。运行后：

• View Results Tree 中可查看每个请求的响应体、响应头
• Summary Report 显示平均响应时间、吞吐量、错误率

▍ 一个合格测试计划的最低配置 ：线程组 + 采样器 + 断言 + 监听器。请记住：只有加断言，测试结果才有意义。

5. HTTP 请求详解

5.1 核心字段

图 3 HTTP 请求面板：协议、服务器、方法与路径等核心字段

|------------------|-----------------------------|-----------------------------|
| 字段 | 说明 | 示例 |
| 字段 | 说明 | 示例 |
| 协议 | http / https | https |
| 服务器名称或 IP | 主机名，可包含端口 | httpbin.org 或 10.0.0.1:8080 |
| 方法 | GET / POST / PUT / DELETE 等 | POST |
| 路径 | 接口路径 | /api/login |
| Content encoding | 编码，建议 UTF-8 | UTF-8 |
| 参数 | GET 查询参数 或 表单参数 | name=john |
| Body Data | 请求体（POST 常用） | JSON 字符串 |

5.2 GET 请求

路径：/get

参数（Query String）：

name = john

age = 18

等价于请求 https://httpbin.org/get?name=john\&age=18

5.3 POST JSON 请求

方法：POST

路径：/post

Content encoding：UTF-8

Body Data：

{"username": "admin", "password": "123456"}

5.4 设置请求头（HTTP Header Manager）

图 4 HTTP Header Manager：为请求添加请求头

右键采样器 → Add → Config Element → HTTP Header Manager，添加：

Content-Type: application/json

Authorization: Bearer <token>

5.5 复用公共配置（HTTP Request Defaults）

如果多个请求都访问同一个服务器，右键线程组 → Add → Config Element → HTTP Request Defaults，统一配置协议和服务器名。子级采样器无需重复填写。

▍ 把不变的配置放在 HTTP Request Defaults，变的部分写在采样器里，脚本更易维护。

6. 断言（Assertions）

断言用于校验响应是否符合预期，是判断请求"成功/失败"的依据。

6.1 响应断言（Response Assertion）

图 5 响应断言面板：校验响应是否包含指定文本

右键采样器 → Add → Assertions → Response Assertion。

配置示例：

要测试的模式： 响应文本（Response Text）

匹配规则： 包含（Contains）

要测试的模式： "success": true

常用匹配规则：

|----------------|---------------------|
| 规则 | 说明 |
| 规则 | 说明 |
| 包含（Contains） | 响应中是否包含指定文本（子串匹配） |
| 匹配（Matches） | 正则匹配整个响应 |
| 等于（Equals） | 完全相等 |
| 字符串（Substring） | 与 Contains 类似，无正则语法 |

6.2 断言失败时的表现

• 请求在结果树中显示为红色
• 汇总报告中的错误率（Error %）上升
• 可通过 Response Assertion 的"自定义失败消息"查看失败原因

6.3 JSON 断言

右键采样器 → Add → Assertions → JSON Assertion：

JSON Path：$.success

Expected Value：true

要求返回的 JSON 中 success 字段为 true。

6.4 持续时间断言（Duration Assertion）

用于校验响应时间不超过阈值：

Duration：1000 （毫秒，超过 1 秒视为失败）

7. 参数化

参数化让不同虚拟用户使用不同数据，更贴近真实场景。

7.1 用户自定义变量（User Defined Variables）

右键线程组 → Add → Config Element → User Defined Variables：

host = https://httpbin.org

username = test01

在采样器中使用 {host}、{username} 引用。

7.2 CSV 数据驱动（CSV Data Set Config）

图 6 CSV Data Set Config：数据驱动参数化

步骤 1：准备 users.csv：

username,password

test01,123456

test02,abcdef

test03,xyz789

步骤 2 ：右键线程组 → Add → Config Element → CSV Data Set Config，配置：

|--------|------------------------------|
| 字段 | 值 |
| 字段 | 值 |
| 文件名 | users.csv（绝对路径或相对 bin 目录） |
| 文件编码 | UTF-8 |
| 变量名称 | username,password |
| 分隔符 | , |
| 是否忽略首行 | True（跳过表头） |
| 循环模式 | 可设置 Recycle 为 True（数据用完重新开始） |

步骤 3：在 HTTP 请求参数 / Body 中使用：

Body Data：{"username": "{username}", "password": "{password}"}

步骤 4 ：线程数设为 CSV 数据行数，每个线程读取一行，实现多用户登录压测。

7.3 内置函数（Functions）

右键参数输入框 → Generate，或直接手写函数：

|--------------------------|------------|---------------------------|
| 函数 | 作用 | 示例 |
| 函数 | 作用 | 示例 |
| {__threadNum} | 当前线程号 | {__threadNum} |
| {__time(YYYY-MM-dd)} | 当前时间 | {__time(2024-01-01)} |
| {__Random(1,100)} | 随机数 | {__Random(1,100)} |
| {__UUID} | 随机 UUID | {__UUID} |
| {__CSVRead(file,index)} | 读取 CSV 指定列 | {__CSVRead(users.csv,0)} |

8. 关联

实际场景中，登录后返回的 token 往往要传给后续请求使用，这称为关联。

8.1 正则表达式提取器（Regular Expression Extractor）

图 7 正则表达式提取器：提取 token 实现关联

场景：登录接口返回 {"token": "abc123"}，订单接口需要在 Header 中使用它。

1. 在登录采样器上右键 → Add → Post Processors → Regular Expression Extractor
2. 配置：

Apply to：Main sample

字段：响应文本

引用名称（Reference Name）：token

正则表达式：\{"token": "(.+?)"\}

模板：1

匹配数字：1

默认值：NOT_FOUND

1. 在订单请求的 Header 中引用：Authorization: Bearer ${token}

▍ 正则中 (.+?) 是非贪婪匹配，用于提取括号内的内容。模板 1 表示取第一个分组。

8.2 JSON 提取器（JSON Extractor）

图 8 JSON Extractor：用 JSON Path 提取字段

需要 JSON Path 更直观：

引用名称：token

JSON Path：$.token

步骤 ：右键登录采样器 → Add → Post Processors → JSON Extractor。

9. 逻辑控制器

控制采样器的执行逻辑。

|------------------------|----------------|
| 控制器 | 作用 |
| 控制器 | 作用 |
| Loop Controller | 循环执行子节点 N 次 |
| If Controller | 满足条件才执行 |
| While Controller | 满足条件时一直循环 |
| Random Controller | 随机执行其中一个子节点 |
| Transaction Controller | 把一组请求合并为一个事务统计 |
| Interleave Controller | 轮流执行子节点 |
| ForEach Controller | 遍历变量数组 |

示例：事务控制器

图 9 事务控制器：把一组请求合并为一个事务统计

把"下单流程"（登录 → 创建订单 → 查询订单）包进 Transaction Controller，报表中会把它当做一个整体事务统计耗时。

▍ 勾选 Generate parent sample 后，事务控制器本身也会生成一条汇总记录，便于统计完整业务链路的耗时。

10. 定时器

定时器控制请求发送的节奏，避免所有线程在瞬间发出请求。

|---------------------------|---------------------|
| 定时器 | 说明 |
| 定时器 | 说明 |
| Constant Timer | 固定等待 N 毫秒 |
| Gaussian Random Timer | 服从高斯分布的随机延迟，更贴近真实用户 |
| Uniform Random Timer | 均匀分布的随机延迟 |
| Constant Throughput Timer | 控制吞吐量（每分钟请求数） |
| Synchronizing Timer | 集合点，让所有线程同时发起请求 |

示例：模拟思考时间

线程组下添加 Gaussian Random Timer：

延迟范围：500 ms （基础 0.5 秒）

标准差： 100 ms

示例：集合点（并发瞬间压测）

图 10 集合点定时器：等待 N 个线程同时发起请求

右键线程组 → Add → Timer → Synchronizing Timer：

Number of Simulated Users to Group：100

Timeout in milliseconds：5000

即：等 100 个线程都到达后，一起发出请求，用于测试服务端瞬间峰值并发能力。

11. 压力测试与并发

11.1 线程组参数含义

|-----------------------------|-------------------------------------|
| 参数 | 说明 |
| 参数 | 说明 |
| Number of Threads | 虚拟用户总数（并发数） |
| Ramp-Up Period | 启动所有线程花费的时间（秒）。0 表示立即全部启动 |
| Loop Count | 每个线程循环执行的次数。勾选 Forever 表示一直跑，直到手动停止 |
| Same user on each iteration | 勾选后，每个迭代使用同一用户数据（配合 CSV 保持登录态时有用） |

11.2 Ramp-Up 的计算建议

Ramp-Up ≈ 并发数 / 每秒目标启动数

• 想要 1 秒启动 5 个线程，100 并发 → Ramp-Up = 20
• 压测通常建议 Ramp-Up 给 5~10 秒，避免启动风暴把网络/代理打满

11.3 常用测试类型

|--------|---------|---------|----------------------|
| 类型 | 线程数 | 循环 | 说明 |
| 类型 | 线程数 | 循环 | 说明 |
| 冒烟测试 | 1~10 | 1~3 | 验证脚本正确、环境连通 |
| 负载测试 | 50~500 | N | 观察系统在预期负载下的表现 |
| 压力测试 | 逐步增加 | Forever | 找到系统拐点 / 最大承载 |
| 稳定性测试 | 适中 | Forever | 长时间运行（如 8 小时）看资源是否泄漏 |

11.4 压测通用流程

1. 先小并发冒烟，确认脚本无误
2. 用少量线程 + 循环验证断言正确性
3. 逐步增加线程数，观察吞吐量（TPS）与响应时间曲线
4. 找到拐点：TPS 不再增长、错误率上升的时间点即系统瓶颈

▍ 重要 ：压测请使用命令行模式（第 13 节），GUI 本身会消耗资源且影响结果，切勿用 GUI 做高压测试。

12. 查看与生成报告

12.1 常用监听器

图 11 View Results Tree：查看单个请求的请求/响应细节

图 12 Summary Report：平均/中位数/90% 分位/吞吐量/错误率

|-------------------------|-----------------------------|
| 监听器 | 用途 |
| 监听器 | 用途 |
| View Results Tree | 查看单个请求的请求/响应细节，调试用 |
| Summary Report | 汇总：平均、中位数、90% 分位、吞吐量、错误率 |
| Aggregate Report | 类似 Summary，含 Min/Max/StdDev |
| Assertion Results | 只看断言失败信息 |
| Graph Results | 曲线图 |
| Response Time Over Time | 响应时间随时间变化（需插件） |

12.2 生成 HTML 报告

先在命令行跑一次并保存结果，然后生成报告：

运行并保存结果到 result.jtl

jmeter -n -t test.jmx -l result.jtl -e -o report-dir

参数说明：

|--------|-----------------------|
| 参数 | 含义 |
| 参数 | 含义 |
| -n | 非 GUI 模式 |
| -t | 指定测试计划 .jmx 文件 |
| -l | 结果日志文件 .jtl |
| -e | 测试结束后生成 HTML 报告 |
| -o | HTML 报告输出目录（必须为空或不存在） |

生成后打开 report-dir/index.html 即可看到图表化报告（吞吐量、响应时间分位数、活跃线程数等）。

13. 命令行（非 GUI）运行

压测和 CI 集成时使用命令行模式：

基础运行

jmeter -n -t demo-api.jmx -l result.jtl

运行 + 生成 HTML 报告

jmeter -n -t demo-api.jmx -l result.jtl -e -o html-report

通过参数覆盖脚本中的自定义变量（如服务器地址）

jmeter -n -t demo-api.jmx -Jhost=httpbin.org -Jthreads=50 -l result.jtl

脚本中引用自定义属性：{__P(host,httpbin.org)}、{__P(threads,10)}。

▍ 远程分布式压测：jmeter -n -R <slave_ip> 可调用远程机执行，具体配置见官方文档。

14. 常用函数与变量

14.1 变量引用方式

|----------------------|--------------------|
| 写法 | 说明 |
| 写法 | 说明 |
| {var} | 引用变量/参数 | | {__P(name,default)} | 命令行参数，可给默认值 |
| {__property(name)} | 引用 properties 文件属性 | | {__V(expr)} | 动态求值（嵌套变量时用） |

14.2 高频函数速查

|--------------------------------|----------|--------------------------------|
| 函数 | 返回值 | 示例 |
| 函数 | 返回值 | 示例 |
| {__Random(1,9999)} | 随机整数 | {__Random(1,9999)} |
| {__time(/1000)} | 当前时间戳（秒） | {__time(/1000)} |
| {__time(YYYY-MM-dd HH:mm:ss)} | 格式化时间 | {__time(2026-08-14 12:00:00)} |
| {__UUID} | UUID 字符串 | {__UUID} |
| {__threadNum} | 当前线程号 | {__threadNum} |
| {__counter(FALSE,id)} | 计数器 | {__counter(FALSE,id)} |
| {__evalVar(var)} | 变量求值 | {__evalVar(host)} |
| {__intSum(a,b)} | 整数求和 | {__intSum(100,${n})} |

14.3 JMeter 内置属性

• ${JMeterThread.last_sample_ok}：上一个采样器是否成功（true/false）
• ${prev}：前一个采样器的 SampleResult 对象
• ${vars}：变量容器（可在 JSR223 中使用）

15. 最佳实践

1. 不要用 GUI 压测：GUI 用于编写和调试，正式压测一律命令行（-n）。
2. 必须加断言：没有断言，错误率永远是 0，结果无意义。
3. 使用 HTTP Request Defaults：统一协议/服务器，减少重复配置、便于迁移环境。
4. 参数化数据：用 CSV 模拟多用户，避免全部线程用同一账号导致服务端缓存干扰结果。
5. 合理设置 Ramp-Up：不要 0 秒瞬间启动所有线程，除非专门测集合点。
6. 分离测试环境：压测会影响被测系统性能，不要在生产直接压（除非有明确授权）。
7. 先小规模验证：10 并发跑通后再放大并发。
8. 监控服务端资源：结合 CPU / 内存 / 数据库连接等指标定位瓶颈，别只看 JMeter 数字。
9. 保持脚本简单：优先用内置组件，JSR223 脚本（Groovy）慎用且要注意性能。
10. 结果可复现：固定线程数、循环、定时器，避免用 GUI 手动点来点去。
11. 不要超时中断：设置合理的连接/响应超时（如 10s），否则 JMeter 会长时间挂起。

16. 常见问题

Q1：启动时提示找不到 Java？

安装 JDK 8+ 并配置 JAVA_HOME 环境变量，重启终端后再启动。

Q2：提示 `OutOfMemoryError`？

修改 bin/jmeter.bat 中的堆内存参数：

set HEAP=-Xms512m -Xmx2g

Q3：为什么响应时间看起来很大？

• 是否包含了思考时间（定时器）
• 是否在 GUI 里运行（GUI 影响性能）
• 采样器是否设置了超时，被网络阻塞挂起

Q4：CSV 中文乱码？

文件保存为 UTF-8（可用 notepad++/VS Code 转换），并在 CSV Data Set Config 中设置文件编码为 UTF-8。

Q5：如何保持登录态？

图 13 HTTP Cookie Manager：自动保存并携带 Cookie 保持登录态

• 用 HTTP Cookie Manager（右键线程组 → Add → Config Element → HTTP Cookie Manager）
• 跨线程组共享登录态时，可把 token 写入文件或用 setProperty / ${__property} 传递

Q6：如何只看失败请求？

View Results Tree 顶部筛选框输入 Error，或直接看 Assertion Results 监听器。

Q7：JMeter 与 Selenium 的区别？

JMeter 走 HTTP 协议层，不渲染页面；Selenium 是真浏览器。性能测试用 JMeter，功能/UI 测试用 Selenium。

附：示例测试计划

仓库中附带 `examples/demo-api.jmx`：

• 线程组：10 个线程，5 秒 Ramp-Up，循环 3 次
• HTTP 请求：GET https://httpbin.org/get?name=${__threadNum}
• 断言：响应包含 "args"，且响应时间小于 5000ms
• 监听器：View Results Tree + Summary Report

运行方式：

jmeter -n -t examples/demo-api.jmx -l result.jtl -e -o report

▍ 注意：httpbin.org 为公网免费测试服务，网络波动可能影响结果，仅用于学习。

参考资源

• 官方文档：<https://jmeter.apache.org/usermanual/\>
• 下载地址：<https://jmeter.apache.org/download_jmeter.cgi\>
• 插件仓库（官方之外，用于增强图表等）：<https://jmeter-plugins.org/\>