Ubuntu 下使用 JMeter 导出 HTML 报告
一 准备与前提
- 安装 Java 8+（JMeter 5.x 推荐），并配置好 JMETER_HOME 与 PATH，确保命令行可直接执行 jmeter -v。示例：
- sudo apt-get update && sudo apt-get install -y openjdk-8-jdk
- java -version
- 将 JMeter 解压至如 /opt/apache-jmeter-5.4.3，并配置环境变量（JMETER_HOME、PATH）后执行 source 使其生效。
二 导出 HTML 报告的两种方式
- 方式一 运行脚本同时生成报告（一次性）
- 命令模板：jmeter -n -t -l -e -o <报告目录>
- 示例：jmeter -n -t /opt/test.jmx -l /opt/test.jtl -e -o /opt/report
- 说明：执行完成后，报告目录中会生成 index.html，用浏览器打开即可查看可视化报告。
- 方式二 基于已有 .jtl 结果文件生成报告
- 命令模板：jmeter -g -e -o <报告目录>
- 示例：jmeter -g /opt/test.jtl -e -o /opt/report_from_jtl
- 说明：适合已留存的历史 .jtl 结果再次生成或重新生成报告。
三 常用参数与目录要求
- 关键参数
- -n：非 GUI 模式运行
- -t：指定 .jmx 测试脚本
- -l：指定结果文件 .jtl（记录采样数据）
- -e：测试结束后生成 HTML 报告
- -o：指定 HTML 报告输出目录
- -g：基于已有 .jtl 生成报告
- 目录与文件约束
- -l 指定的 .jtl 文件必须不存在（否则报错），执行时会写入采样日志。
- -o 指定的报告目录必须为空或不存在（否则报错），用于存放 index.html 等报告文件。
四 查看与汉化报告
- 查看报告
- 在 Ubuntu 本机可用：xdg-open /opt/report/index.html
- 远程查看可将报告目录拷贝到本地后打开 index.html。
- 汉化报告（可选）
- 下载适配 JMeter 4.x/5.x 的中文报表模板，将解压后的 report-template 覆盖到 $JMETER_HOME/bin/report-template，再按上述命令生成报告即可显示中文。
五 常见报错与处理
- 报错示例
- “Results file: report.jtl is not empty” 或 “Cannot write to ‘…/report’ as folder is not empty”
- 处理办法
- 删除已存在的同名 .jtl 文件，或清空/更换 -o 指定的报告目录后重试。
- 若仅基于历史 .jtl 重新生成报告，使用：jmeter -g test.jtl -e -o /path（确保 /path 为空）。
