摘要:本文面向 Jmeter 新手,完整演示第一个测试计划的搭建过程:检查 Java 环境并启动 Jmeter 5.6.3,用 Python 在本机
127.0.0.1:18080启动临时 HTTP 服务,创建 5 线程、循环 2 次的线程组与 HTTP 请求,添加查看结果树和聚合报告两个监听器,运行后核对 10 个样本、错误率 0,并解读样本数、异常率、吞吐量和 P90 等指标。最后说明.jmx的保存与再次打开方式,并给出访问失败、样本数异常等常见问题的排查思路。
刚打开 Jmeter 时,左边是空的测试计划,右边是各种配置项:线程组在哪里添加?HTTP 地址该填在哪几个框里?运行后又怎么看是否成功?
本文带你从安装开始,向自己电脑上的临时 HTTP 服务发送 10 个请求,完成第一个 Jmeter 测试计划。做完后,你会创建线程组和 HTTP 请求、查看运行结果、保存 .jmx 文件,并知道聚合报告中的几个指标是什么意思。
练习环境:Jmeter 5.6.3、Java 21、macOS,验证日期为 2026 年 11 月 18 日。Windows 的菜单操作相同,终端命令和启动脚本见下文。截图来自本文在 Jmeter 中的实际操作,红框用于标出关键区域;界面语言和不同系统的外观可能略有差异。
本文使用
127.0.0.1上的本地服务做小规模功能验证,不能据此得出系统容量或性能结论。对其他系统开展负载测试前,应先取得授权。
一、准备 Java 和 Jmeter
1. 检查 Java
在 macOS 打开「终端」,Windows 打开 PowerShell,输入:
java -version
如果输出包含 Java 版本号,例如 21.0.8,说明当前终端能找到 Java。Jmeter 5.6.3 支持 Java 8 及以上,官方推荐使用较新的 Java 版本;本文使用 Java 21。
如果提示找不到命令,先安装 JDK,例如 Eclipse Temurin,然后关闭并重新打开终端,再次执行 java -version。如果安装过 Java 仍不识别,检查 PATH 和 JAVA_HOME,并确认当前终端使用的是预期版本。
2. 下载并启动 Jmeter
- 打开 Apache Jmeter 下载页。
- 找到 Binaries,不要选择 Source。macOS / Linux 可以下载
.tgz,Windows 下载.zip。 - 解压到有读写权限的目录。为了减少新手排查路径问题,示例可放在
~/tools/或D:\tools\。 - 打开解压后的目录,找到
bin:macOS / Linux 在终端进入该目录后运行./jmeter;Windows 双击jmeter.bat。如果 macOS / Linux 提示无执行权限,可在确认文件来源后执行chmod +x jmeter。 - 等待桌面窗口出现。左侧应该看到 Test Plan(测试计划),右侧是所选节点的配置面板。
macOS 如果使用 Homebrew,也可以执行 brew install jmeter,之后输入 jmeter 启动。本文演示环境使用的是 Homebrew 安装的 5.6.3。
想使用中文界面,可在顶部菜单选择 Options → Choose Language → Chinese (Simplified)。下文同时给出中文和英文名称;语言切换后,菜单文字可能因版本而略有差异。
如果启动失败,在终端运行启动脚本并查看报错;先用
java -version检查 Java,再根据实际错误检查JAVA_HOME、路径和权限。
二、启动本地练习服务
为了让练习不依赖公网接口,先在自己电脑上启动一个临时 HTTP 服务。它只用于返回一个本地目录页面。
-
新建一个空文件夹,例如
jmeter-demo,并打开终端进入它。下面的两条命令在 macOS 终端或 Windows PowerShell 中均可使用:mkdir jmeter-demo cd jmeter-demo -
启动服务。macOS 通常使用
python3;Windows 如果python不可用,可尝试py:python3 -m http.server 18080 --bind 127.0.0.1Windows PowerShell:
python -m http.server 18080 --bind 127.0.0.1 -
保持这个终端窗口打开。打开浏览器访问
http://127.0.0.1:18080/:能看到目录列表,即表示服务已启动。空目录也可以正常使用。 -
如果提示端口已被占用,换一个空闲端口,并在后面的 HTTP 请求配置里同步修改;如果提示找不到 Python,需要先安装 Python 并让终端能找到它。
练习完成后,回到运行服务的终端按 Ctrl+C 停止。该命令将本地目录通过 HTTP 提供给本机访问,不要在含敏感文件的目录中启动。
三、创建线程组:设置 5 个线程、循环 2 次
Jmeter 的测试计划是一棵树。先添加线程组,用它定义有多少个虚拟用户、如何启动以及每个用户执行几轮。
- 在左侧树中右键 测试计划(Test Plan)。
- 依次选择 添加(Add)→ 线程(用户)(Threads (Users))→ 线程组(Thread Group)。
- 单击新出现的「线程组」,在右侧面板找到以下字段并修改:
| 字段 | 本例填写 | 含义 |
|---|---|---|
| 线程数 / Number of Threads (users) | 5 | 配置 5 个虚拟用户线程 |
| Ramp-Up 时间(秒)/ Ramp-up period | 2 | 按约 2 秒的起步周期陆续启动线程 |
| 循环次数 / Loop Count | 2 | 每个线程执行两轮;不要勾选 Infinite |

图:本例实际线程组配置;左侧红框展示完成后的测试计划结构。
本例每轮只有一个 HTTP 请求,所以正常完成时预计得到 5 × 2 × 1 = 10 个请求样本。线程数是配置的虚拟用户数,不保证任意时刻都有 5 个请求同时进行。在 5 个线程、Ramp-Up 为 2 秒时,启动间隔约为 0.4 秒;第一个线程立即启动,最后一个约在 1.6 秒启动。请求很快时,较早的线程甚至可能在后面的线程启动前结束。
四、添加 HTTP 请求
- 在左侧树中右键刚创建的 线程组(Thread Group)。
- 选择 添加(Add)→ 取样器(Sampler)→ HTTP 请求(HTTP Request)。
- 单击「HTTP 请求」,在右侧配置面板填写:
| 配置项 | 填写值 |
|---|---|
| 协议 / Protocol | http |
| 服务器名称或 IP / Server Name or IP | 127.0.0.1 |
| 端口号 / Port Number | 18080 |
| 方法 / Method | GET |
| 路径 / Path | / |
协议、主机和端口分别填写,不要把完整 URL 粘贴进服务器名称框。如果前一步换了端口,这里也要改成相同的端口。其余选项先保持默认。

图:本例 HTTP 请求配置,红框内的值分别对应上表。
配置完成后,这个取样器要访问的地址就是 http://127.0.0.1:18080/。在浏览器能访问,不代表 Jmeter 一定配置正确;下一步还要查看 Jmeter 的实际结果。
五、添加监听器并检查层级
监听器用于观察测试结果。这里先添加两个:
- 右键左侧的 线程组,选择 添加 → 监听器(Listener)→ 查看结果树(View Results Tree)。
- 再次右键 线程组,选择 添加 → 监听器 → 聚合报告(Aggregate Report)。
- 展开线程组,确认三个节点同级:
测试计划
└── 线程组
├── HTTP 请求
├── 查看结果树
└── 聚合报告
本例中两个监听器挂在线程组下,可观察该线程组内 HTTP 请求的样本。查看结果树适合检查单条请求和响应;聚合报告按请求标签汇总样本指标。
查看结果树会保存和展示响应数据,样本量大时会消耗较多资源。正式负载测试通常使用 CLI 模式,并精简监听器和结果采集配置;本篇的 GUI 运行只用于小规模调试。
六、运行并验证结果
1. 清除旧结果并启动
- 如果之前运行过,选择菜单 运行(Run)→ 清除全部(Clear All),避免旧结果与本次结果混在一起。
- 点击工具栏的绿色三角形,或选择 运行 → 启动(Start)。
- 稍等几秒,观察窗口右上方的活动线程数归零,再检查监听器。
如果本地服务仍在运行,其终端也会显示 GET / 的访问记录。
2. 查看单条请求
- 单击左侧的 查看结果树。
- 在结果列表选择一条样本,打开 取样器结果(Sampler result),检查响应码是否为
200、是否标记为成功。 - 切换到 请求(Request),核对请求地址;再打开 响应数据(Response data),确认返回的是本地服务的目录页面。
- 检查列表是否有失败样本。绿色只表示 Jmeter 将该样本判为成功,不等于业务数据一定正确;真实业务需要针对状态码和响应内容设计断言。

图:本机实际运行结果;左侧为 10 条样本,右侧选中样本的响应码为 200。
3. 查看聚合报告
单击左侧 聚合报告。找到 HTTP 请求对应的行,以及汇总行 TOTAL:
- # 样本(# Samples):正常完成后应为
10。若不同,先检查循环次数、取样器是否启用、监听器位置和测试是否提前停止。 - 异常 %(Error %):本例期望为
0.00%。若不是,回到查看结果树,选中失败样本查看响应码和错误信息。 - 吞吐量(Throughput):单位时间内完成的样本数,界面可能显示
/sec、/min或/hour。本例每个样本对应一次 HTTP 请求;实际业务中不能不加区分地把它等同于事务 TPS。 - 90% 百分位(90% Line / P90):约 90% 的样本耗时不超过该值。它描述请求样本的耗时分布,不等于 90% 的用户体验。

图:本机一次 GUI 运行的聚合报告;数值会随环境和运行情况变化。
例如,某组足够多的请求样本 P90 为 800 ms,可以理解为约 90% 的样本耗时不超过 800 ms;仍要结合样本量、失败率和业务目标判断。本练习只有 10 个样本,百分位和吞吐量波动很大,只用来认识字段。
本例在上述环境中通过 GUI 和命令行分别验证过:两次均为 10 个样本,错误数 0。运行方式、机器和时间都会影响耗时,因此你的数字不需要与别人一致。这只能说明该次请求链路跑通,不能说明系统能承受多少并发。
七、保存和再次打开
选择 文件(File)→ 保存测试计划为(Save Test Plan As),输入 first-load-test.jmx 并保存。下次选择 文件 → 打开(Open),找到该文件即可继续编辑。
.jmx 保存的是测试计划配置,不包含监听器中已显示的运行结果。再次运行前检查本地服务仍在运行,并清除旧结果。配套示例文件 first-load-test.jmx 可用于核对配置;在 Jmeter 中打开后,确认目标为本机 127.0.0.1:18080 再运行。
八、遇到问题怎么查
1. 浏览器和 Jmeter 都访问不了本地地址
先看服务终端是否还在运行,确认地址为 http://127.0.0.1:18080/,检查端口是否一致。如果服务启动时提示端口占用,换端口并同步修改 Jmeter。
2. 浏览器能打开,Jmeter 报错或出现红色样本
在查看结果树中选中失败样本,先读「取样器结果」中的响应码和错误信息;再检查协议是否为 http、主机是否为 127.0.0.1、端口是否为 18080、路径是否为 /。Connection refused 常见于目标端口没有服务监听;连接超时则要检查目标、网络和服务状态,不能仅凭报错认定原因。
3. 样本数不是 10
确认线程数为 5、循环次数为 2、未勾选无限循环;确认 HTTP 请求没有被禁用,两个监听器挂在线程组下,运行没有提前停止。重新运行前清除全部结果。
4. 第二次运行显示 20 个样本
监听器可能保留了上次结果。使用 运行 → 清除全部,然后重新启动;如果需要比较两次运行,请分别保存结果,不要把累加数据当成单次测试。
写在最后
第一篇完成的目标是建立一条可检查的请求链路:启动本地服务、配置线程组和 HTTP 请求、查看响应、保存测试计划。线程数、吞吐量和百分位是后续性能测试的基础,但 10 个本地请求还远不足以说明容量。
下一步可以学习参数化与 CSV 数据驱动,让不同线程使用不同输入;再结合断言判断响应内容是否符合预期。
转载自 CSDN-专业IT技术社区
原文链接:https://blog.csdn.net/m0_69976180/article/details/170973756




