测开Harvey头像
Jmeter 入门教程 01:从安装到运行,第一个 HTTP 请求测试实战封面图

Jmeter 入门教程 01:从安装到运行,第一个 HTTP 请求测试实战

摘要:本文面向 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

  1. 打开 Apache Jmeter 下载页。
  2. 找到 Binaries,不要选择 Source。macOS / Linux 可以下载 .tgz,Windows 下载 .zip。
  3. 解压到有读写权限的目录。为了减少新手排查路径问题,示例可放在 ~/tools/ 或 D:\tools\。
  4. 打开解压后的目录,找到 bin:macOS / Linux 在终端进入该目录后运行 ./jmeter;Windows 双击 jmeter.bat。如果 macOS / Linux 提示无执行权限,可在确认文件来源后执行 chmod +x jmeter。
  5. 等待桌面窗口出现。左侧应该看到 Test Plan(测试计划),右侧是所选节点的配置面板。

macOS 如果使用 Homebrew,也可以执行 brew install jmeter,之后输入 jmeter 启动。本文演示环境使用的是 Homebrew 安装的 5.6.3。

想使用中文界面,可在顶部菜单选择 Options → Choose Language → Chinese (Simplified)。下文同时给出中文和英文名称;语言切换后,菜单文字可能因版本而略有差异。

如果启动失败,在终端运行启动脚本并查看报错;先用 java -version 检查 Java,再根据实际错误检查 JAVA_HOME、路径和权限。

二、启动本地练习服务

为了让练习不依赖公网接口,先在自己电脑上启动一个临时 HTTP 服务。它只用于返回一个本地目录页面。

  1. 新建一个空文件夹,例如 jmeter-demo,并打开终端进入它。下面的两条命令在 macOS 终端或 Windows PowerShell 中均可使用:

    mkdir jmeter-demo
    cd jmeter-demo
    
  2. 启动服务。macOS 通常使用 python3;Windows 如果 python 不可用,可尝试 py:

    python3 -m http.server 18080 --bind 127.0.0.1
    

    Windows PowerShell:

    python -m http.server 18080 --bind 127.0.0.1
    
  3. 保持这个终端窗口打开。打开浏览器访问 http://127.0.0.1:18080/:能看到目录列表,即表示服务已启动。空目录也可以正常使用。

  4. 如果提示端口已被占用,换一个空闲端口,并在后面的 HTTP 请求配置里同步修改;如果提示找不到 Python,需要先安装 Python 并让终端能找到它。

练习完成后,回到运行服务的终端按 Ctrl+C 停止。该命令将本地目录通过 HTTP 提供给本机访问,不要在含敏感文件的目录中启动。

三、创建线程组:设置 5 个线程、循环 2 次

Jmeter 的测试计划是一棵树。先添加线程组,用它定义有多少个虚拟用户、如何启动以及每个用户执行几轮。

  1. 在左侧树中右键 测试计划(Test Plan)。
  2. 依次选择 添加(Add)→ 线程(用户)(Threads (Users))→ 线程组(Thread Group)。
  3. 单击新出现的「线程组」,在右侧面板找到以下字段并修改:
字段本例填写含义
线程数 / Number of Threads (users)5配置 5 个虚拟用户线程
Ramp-Up 时间(秒)/ Ramp-up period2按约 2 秒的起步周期陆续启动线程
循环次数 / Loop Count2每个线程执行两轮;不要勾选 Infinite

请添加图片描述

图:本例实际线程组配置;左侧红框展示完成后的测试计划结构。

本例每轮只有一个 HTTP 请求,所以正常完成时预计得到 5 × 2 × 1 = 10 个请求样本。线程数是配置的虚拟用户数,不保证任意时刻都有 5 个请求同时进行。在 5 个线程、Ramp-Up 为 2 秒时,启动间隔约为 0.4 秒;第一个线程立即启动,最后一个约在 1.6 秒启动。请求很快时,较早的线程甚至可能在后面的线程启动前结束。

四、添加 HTTP 请求

  1. 在左侧树中右键刚创建的 线程组(Thread Group)。
  2. 选择 添加(Add)→ 取样器(Sampler)→ HTTP 请求(HTTP Request)。
  3. 单击「HTTP 请求」,在右侧配置面板填写:
配置项填写值
协议 / Protocolhttp
服务器名称或 IP / Server Name or IP127.0.0.1
端口号 / Port Number18080
方法 / MethodGET
路径 / Path/

协议、主机和端口分别填写,不要把完整 URL 粘贴进服务器名称框。如果前一步换了端口,这里也要改成相同的端口。其余选项先保持默认。

请添加图片描述

图:本例 HTTP 请求配置,红框内的值分别对应上表。

配置完成后,这个取样器要访问的地址就是 http://127.0.0.1:18080/。在浏览器能访问,不代表 Jmeter 一定配置正确;下一步还要查看 Jmeter 的实际结果。

五、添加监听器并检查层级

监听器用于观察测试结果。这里先添加两个:

  1. 右键左侧的 线程组,选择 添加 → 监听器(Listener)→ 查看结果树(View Results Tree)。
  2. 再次右键 线程组,选择 添加 → 监听器 → 聚合报告(Aggregate Report)。
  3. 展开线程组,确认三个节点同级:
测试计划
└── 线程组
    ├── HTTP 请求
    ├── 查看结果树
    └── 聚合报告

本例中两个监听器挂在线程组下,可观察该线程组内 HTTP 请求的样本。查看结果树适合检查单条请求和响应;聚合报告按请求标签汇总样本指标。

查看结果树会保存和展示响应数据,样本量大时会消耗较多资源。正式负载测试通常使用 CLI 模式,并精简监听器和结果采集配置;本篇的 GUI 运行只用于小规模调试。

六、运行并验证结果

1. 清除旧结果并启动

  1. 如果之前运行过,选择菜单 运行(Run)→ 清除全部(Clear All),避免旧结果与本次结果混在一起。
  2. 点击工具栏的绿色三角形,或选择 运行 → 启动(Start)。
  3. 稍等几秒,观察窗口右上方的活动线程数归零,再检查监听器。

如果本地服务仍在运行,其终端也会显示 GET / 的访问记录。

2. 查看单条请求

  1. 单击左侧的 查看结果树。
  2. 在结果列表选择一条样本,打开 取样器结果(Sampler result),检查响应码是否为 200、是否标记为成功。
  3. 切换到 请求(Request),核对请求地址;再打开 响应数据(Response data),确认返回的是本地服务的目录页面。
  4. 检查列表是否有失败样本。绿色只表示 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

文章来源转载

评论

评论列表

微信小程序
QQ小程序

关于作者

点赞数:0
关注数:0
粉丝:0
文章:0
关注标签:0
加入于:--