2. JMeter 基础安装：JDK 环境配置、JMeter 下载与安装、目录结构解析、启动与验证

JMeter 是一款纯 Java 应用，其运行依赖 JDK（Java Development Kit）提供的 JVM 运行时环境。本章将完整演示从 JDK 配置到 JMeter 启动验证的全流程，并解析核心目录结构，为后续编写压测脚本打下基础。

2.1 JDK 环境配置

JMeter 5.x 要求 JDK 8 及以上版本（推荐 JDK 11 LTS）。配置步骤如下：

  1. 下载 JDK：从 Oracle 官网或 Adoptium 社区下载 JDK 11 安装包。
  2. 安装 JDK：默认路径安装（Windows 建议 C:\Program Files\Java\jdk-11，Linux/Mac 建议 /usr/lib/jvm/jdk-11）。
  3. 配置环境变量：
    • JAVA_HOME：指向 JDK 安装根目录。
    • PATH：追加 %JAVA_HOME%\bin（Windows）或 $JAVA_HOME/bin（Linux/Mac）。
  4. 验证安装：打开终端执行 java -version，确认输出包含 JDK 版本号。

关键验证命令：java -version 输出示例：

openjdk version "11.0.20" 2023-07-18 LTS
OpenJDK Runtime Environment (build 11.0.20+8)
OpenJDK 64-Bit Server VM (build 11.0.20+8, mixed mode)

若提示“java 不是内部或外部命令”，请检查 JAVA_HOME 路径是否正确，并重新加载环境变量。

2.2 JMeter 下载与安装

JMeter 为绿色免安装软件，下载后解压即可使用。推荐从 Apache 官方镜像站获取最新稳定版。

步骤 操作说明 注意事项
1. 下载 访问 https://jmeter.apache.org/download_jmeter.cgi，选择 Binaries 下的 apache-jmeter-5.6.3.zip 不要下载 Source 包，Source 包需自行编译
2. 解压 解压至无中文、无空格的路径，如 D:\tools\apache-jmeter-5.6.3 路径含空格或中文可能导致插件加载失败
3. 目录确认 解压后应包含 bin、lib、docs 等核心文件夹 若缺少 lib/ext 目录，手动创建

版本选择建议：生产环境优先使用 JMeter 5.5 及以上版本，支持 HTTP/2、JSON 断言增强等特性。避免使用 5.0 以下版本，其插件生态已不活跃。

2.3 目录结构解析

JMeter 安装目录包含多个关键子目录，理解其作用有助于后续插件管理、脚本存放和日志排查。核心目录结构如下：

JMeter 核心目录结构 apache-jmeter-5.6.3 bin lib docs extras 启动脚本 jmeter.bat/sh jmeter-server 脚本 核心依赖 lib/ext 插件目录 lib/ 基础 JAR API 文档 JavaDoc 离线版 用户手册 辅助工具 Ant/Maven 集成 报告模板 目录功能速查 • bin/：启动/停止脚本、配置文件 jmeter.properties • lib/ext/：第三方插件（如 jpgc 插件）放置于此 • lib/：JMeter 自身 JAR 包，一般无需手动修改 • docs/：离线 API 文档，开发插件时参考

常见误区：不要将用户自定义的测试计划（.jmx 文件）存放在 bin/ 目录下。建议在安装目录外单独创建 test-plans/ 和 reports/ 文件夹，避免升级 JMeter 时误删脚本。

2.4 启动与验证

JMeter 提供 GUI 模式和命令行（CLI）模式两种启动方式。GUI 用于脚本调试，CLI 用于生产压测。

2.4.1 GUI 模式启动

  • Windows：双击 bin/jmeter.bat。
  • Linux/Mac：终端执行 sh bin/jmeter.sh。

启动后出现 JMeter 主界面，默认包含测试计划树、菜单栏和工具栏。首次启动可能弹出安全警告，点击“运行”即可。

2.4.2 CLI 模式启动（验证）

CLI 模式用于执行压测脚本并生成报告，是生产环境唯一推荐模式。验证命令：

# 进入 bin 目录后执行
jmeter -n -t /path/to/test.jmx -l /path/to/results.jtl -e -o /path/to/report

参数说明：

参数 含义 是否必填
-n 非 GUI 模式运行 是
-t 指定测试计划文件路径（.jmx） 是
-l 指定结果日志文件路径（.jtl） 是
-e 测试结束后生成 HTML 报告 否
-o HTML 报告输出目录（需为空目录） 与 -e 配合使用

快速验证示例：使用 JMeter 自带的示例脚本 extras/TestPlan.jmx 执行一次压测：

cd apache-jmeter-5.6.3/bin
jmeter -n -t ../extras/TestPlan.jmx -l ../test-output.jtl

执行完成后，查看 test-output.jtl 文件大小是否大于 0，若大于 0 则说明 JMeter 安装配置正确。

2.5 启动常见问题排查

现象 原因 解决方案
双击 jmeter.bat 无反应 JAVA_HOME 未配置或指向 JRE 而非 JDK 检查 JAVA_HOME 是否包含 bin/javac.exe
启动后界面英文乱码 系统编码与 JMeter 默认编码不一致 修改 bin/jmeter.properties 中 sampleresult.default.encoding=UTF-8
CLI 模式报错“OutOfMemoryError” JVM 堆内存不足 修改 bin/jmeter 脚本中 HEAP="-Xms1g -Xmx4g"
插件无法加载 插件 JAR 未放入 lib/ext 目录 将 .jar 文件复制到 lib/ext 后重启 JMeter

生产环境建议：压测前务必调整 JVM 参数。对于 4C8G 的压测机，推荐设置 HEAP="-Xms4g -Xmx8g"，并添加 JVM_ARGS="-server -XX:+UseG1GC" 以提升 GC 效率。

← 上一章 📖 返回目录 下一章 →