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 为空)。