JMH是专为解决JVM微基准测试失真问题设计的工具，通过进程隔离、多轮预热、统计采样和反优化保护实现纳秒级精度。
直接用 System.nanoTime() 或 currentTimeMillis() 测方法耗时，结果往往失真——JVM 的 JIT 编译、死代码消除、GC 干扰、预热不足都会让数字“看起来快”，实际不可靠。JMH 就是专为解决这些问题设计的微基准测试工具，它通过进程隔离、多轮预热、统计采样和反优化保护，把测量精度推到纳秒级。
添加依赖并配置构建
在 Maven 的 pom.xml 中引入 JMH 核心组件（仅用于测试阶段）：
<dependency>
<groupId>org.openjdk.jmh</groupId>
<artifactId>jmh-core</artifactId>
<version>1.36</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.openjdk.jmh</groupId>
<artifactId>jmh-generator-annprocess</artifactId>
<version>1.36</version>
<scope>test</scope>
</dependency>
注意：必须启用注解处理器（IDE 中需开启 annotation processing），否则 @Benchmark 不会生效。
立即学习“Java免费学习笔记（深入）”；
编写标准基准测试类
一个可运行的 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、或增加预热轮次。
