jmh是专为解决jvm微基准测试失真问题设计的工具,通过进程隔离、多轮预热、统计采样和反优化保护实现纳秒级精度。

直接用 System.nanoTime() 或 currentTimeMillis() 测方法耗时,结果往往失真——JVM 的 JIT 编译、死代码消除、GC 干扰、预热不足都会让数字“看起来快”,实际不可靠。JMH 就是专为解决这些问题设计的微基准测试工具,它通过进程隔离、多轮预热、统计采样和反优化保护,把测量精度推到纳秒级。
添加依赖并配置构建
在 Maven 的 pom.xml 中引入 JMH 核心组件(仅用于测试阶段):
注意:必须启用注解处理器(IDE 中需开启 annotation processing),否则 @Benchmark 不会生效。
编写标准基准测试类
一个可运行的 JMH 类需满足几个关键点:
- 用
@State(Scope.Benchmark)或@State(Scope.Thread)标记测试类,管理共享或线程独有状态 - 用
@Setup(Level.Trial)初始化数据(如构造数组、加载配置),避免计入测量开销 - 用
@Benchmark标记待测方法,且该方法必须是public、无参数、有返回值或 void - 推荐显式指定模式与单位,例如:
@BenchmarkMode(Mode.AverageTime)@OutputTimeUnit(TimeUnit.NANOSECONDS)
示例片段:
@State(Scope.Thread)
@BenchmarkMode(Mode.AverageTime)
@OutputTimeUnit(TimeUnit.NANOSECONDS)
public class StringConcatBenchmark {
private String a = "hello";
private String b = "world";
@Benchmark
public String concatWithPlus() {
return a + b;
}
@Benchmark
public String concatWithBuilder() {
return new StringBuilder().append(a).append(b).toString();
}
}
控制预热与测量过程
JMH 默认只做简单预热,生产级对比建议显式配置:
-
@Warmup(iterations = 5, time = 1, timeUnit = TimeUnit.SECONDS):5 轮预热,每轮 1 秒,让 JIT 充分编译 -
@Measurement(iterations = 5, time = 1, timeUnit = TimeUnit.SECONDS):5 轮正式测量,每轮 1 秒,取稳定值 -
@Fork(3):启动 3 个独立 JVM 进程执行测试,消除进程级干扰(如 GC 偏差) -
@Threads(4):用 4 个线程并发执行基准方法,适合评估多线程场景
这些注解可加在类上,全局生效;也可加在单个 @Benchmark 方法上,精细控制。
运行与解读结果
两种常用方式:
-
命令行打包运行:执行
mvn clean package后,运行生成的benchmarks.jar:java -jar target/benchmarks.jar -rf json -rff result.json(输出 JSON 格式便于后续分析) -
IDE 内运行:在测试类中写 main 方法,用
Runner启动:new Runner(new OptionsBuilder().include(".*StringConcatBenchmark.*").build()).run();
典型输出中关注三列:
- Score:核心指标值(如平均耗时 12.422 ns/op)
- Error:标准差(如 ±0.179 ns/op),越小说明结果越稳定
- Units:单位(如 ns/op 表示“每次调用纳秒数”)
若误差超过 5%,说明测试受干扰较大,应检查状态管理、是否遗漏 @Setup、或增加预热轮次。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











