【超详细图文教程】2025年最新 Jmeter 详细安装教程及接口测试示例

2025年最新 Jmeter 详细安装教程及接口测试示例

---

---

前言

在软件测试领域，接口测试是保障系统稳定性与数据准确性的关键环节，而 Apache Jmeter 作为一款开源、功能强大的性能测试与接口测试工具，凭借其支持多协议、可扩展性强、操作灵活等优势，成为测试工程师的核心工具之一。无论是验证单个接口的功能正确性，还是模拟高并发场景下的系统性能表现，Jmeter 都能高效满足需求。

---

一、JDK 安装与配置（详细步骤）

Jmeter 是基于 Java 开发的，因此需要先安装 Java 环境。

1.1 JDK 下载

• 访问 Oracle 官网 JDK 下载（https://www.oracle.com/java/technologies/downloads/）
• 选择 “Java SE 8” 或更高版本（推荐 JDK 8，兼容性最好
• 点击对应 Windows 版本的下载链接（x64 适用于 64 位系统）
  
• 接受许可协议，登录 Oracle 账号后即可下载（若无账号需注册）
  

1.2 JDK 安装

• 双击下载的 jdk-8uXXX-windows-x64.exe 文件
  

• 点击 “下一步”，建议保持默认安装路径（C:\Program Files\Java\jdk1.8.0_XXX）
  
  

• 安装JRE，建议保持默认安装路径（C:\Program Files\Java\jre1.8.0_XXX）
  

• 等待安装完成（包含 JDK 和 JRE 两部分）

1.3 环境变量配置（图文步骤）

• 右键 “此电脑” → 选择 “属性” → 点击左侧 “高级系统设置”

  • 在弹出窗口中点击 “环境变量” 按钮
  • 在 “系统变量” 区域点击 “新建”：
  • 变量名：JAVA_HOME，变量值：C:\Program Files\Java\jdk1.8.0_XXX（替换为实际安装路径）
    

• 找到并选中 “Path” 变量，点击 “编辑”：

  • 点击 “新建”，添加 %JAVA_HOME%\bin
  • 再次点击 “新建”，添加 %JAVA_HOME%\jre\bin
    

• 点击 “新建”，创建 CLASSPATH 变量：

  • 变量名：CLASSPATH
  • 变量值：.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar（注意开头的点和分号）
    

• 依次点击 “确定” 关闭所有窗口

1.4 验证 JDK 安装

• 按下 Win + R，输入 cmd 打开命令提示符
• 输入 java -version，应显示类似以下信息：
• 输入 javac -version，应显示相同版本号，确认 JDK 安装成功
  

---

二、Jmeter 安装与配置（详细步骤）

2.1 Jmeter 下载

• 访问 Apache Jmeter 官网（https://jmeter.apache.org/）

• 点击首页的 “Download” 链接
  

• 在下载页面中，找到 “Binaries” 部分，下载 apache-jmeter-5.6.zip（linux选择tgz）
  

2.2 Jmeter 安装

• 将下载的压缩包解压到纯英文路径（重要）
• 推荐路径：D:\soft\apache-jmeter-5.6
• 避免路径中包含空格和中文，如 D:\Program Files 或 D:\软件 都不推荐
• 解压完成后，文件夹结构如下：
  • bin：可执行文件
  • docs 目录：包含 JMeter 的用户手册和相关接口、样式、图片等
  • extras：额外工具
  • lib：依赖库
  • license：软件的许可证
  • printable_docs：可打印版本文档目录

2.3 Jmeter 环境变量配置

• 打开 “环境变量” 配置窗口（步骤同上）
• 点击 “新建”，创建 JMETER_HOME 变量：
• 变量名：JMETER_HOME，变量值：D:\soft\apache-jmeter-5.6（替换为实际解压路径）

• 编辑 “Path” 变量，添加：%JMETER_HOME%\bin

• 点击 “确定” 保存配置

2.4 验证 Jmeter 安装

打开命令提示符，输入 jmeter -v
若显示版本信息和版权声明，则安装成功：

2.5 WARN问题处理

JMeter 出现 “WARN StatusConsoleListener The use of package scanning to locate plugins is deprecated and will be removed in a future release” 警告，是因为 JMeter 新版本中不再推荐使用包扫描方式来定位插件，这是一个兼容性警告（非错误），可以通过以下方式处理：

• 打开 JMeter 安装目录下的 bin/log4j2.xml 文件，把其中的 WARN 改为 ERROR 或更高级别。

修改前：<Configuration status="WARN" packages="org.apache.jmeter.gui.logging">
修改后：<Configuration status="ERROR" packages="org.apache.jmeter.gui.logging"

备注：Status 共有 8 个可选值，级别由低到高依次为：all、trace、debug、info、warn、error、fatal 和 off。

• 再次验证告警信息是否存在，使用jmeter -V；

---

三、Jmeter 启动与界面介绍

3.1 启动方式

方式一：命令行启动

• 打开命令提示符，输入 jmeter 并回车
  

方式二：直接启动

• 进入 Jmeter 安装目录的 bin 文件夹
• 双击 jmeter.bat（Windows 批处理文件）

• 首次启动会打开一个命令窗口和 Jmeter 图形界面，不要关闭命令窗口

命令窗口提示，翻译成中文如下：

================================================================================
不要使用GUI模式进行负载测试！此模式仅适用于测试创建和测试调试。
对于负载测试，请使用CLI模式（NON GUI模式）：jmeter -n -t [jmx file] -l [results file] -e -o [Path to web report folder]
并且增加Java堆以满足您的测试要求：
在jmeter.bat/jmeter.sh文件修改当前的env变量HEAP="-Xms1g -Xmx1g -XX:MaxMetaspaceSize=256m"
具体请查看官方文档：https://jmeter.apache.org/usermanual/best-practices.html
================================================================================

3.2 界面组成

• 菜单栏：包含所有操作命令
• 工具栏：常用功能快捷按钮
• 左侧面板：测试计划结构树
• 右侧面板：选中元素的详细配置
• 底部状态栏：显示当前状态信息

3.3 界面优化（可选）

解决中文乱码：

• 打开 bin 目录下的 jmeter.properties 文件
• 找到 sampleresult.default.encoding 配置项
• 将其值改为 UTF-8（去掉前面的注释符号 #）
• 保存文件并重启 Jmeter

---

四、高级配置与常见问题

4.1 批量执行测试

可以通过命令行非 GUI 模式运行测试计划，提高性能：

jmeter -n -t D:\testplans\api_test.jmx -l D:\results\test_result.jtl-n：非 GUI 模式
-t：指定测试计划文件
-l：指定结果文件

4.2 常见问题解决

• 启动报错 “Could not find Java”：检查 JAVA_HOME 配置是否正确
• 中文显示为方框：修改 bin/jmeter.properties 中的 jmeter.gui.font 相关配置
• 请求超时：在 HTTP 请求中设置 “超时（毫秒）”，如连接超时和响应超时都设为 5000
• 证书问题：测试 HTTPS 接口时若遇到证书错误，可在 bin/user.properties 中添加：

https.use.cached.ssl.context=true

---

总结

通过这个详细教程，了解了Jmeter 的安装配置，还解决了部分常见问题。Jmeter 功能强大，建议继续探索其逻辑控制器、定时器、变量提取等高级功能，以应对更复杂的测试需求。