进阶:GraalVM Native Image 与 AOT 优化
本篇要点:算清一个服务的启动预算,判断它该用 JVM、AOT Cache 还是原生镜像,并说得出这个选择在构建期和运维期各要付多少。前置文章:《配置与可观测性:Profiles、Actuator 与 Micrometer》把健康检查与探针接上了,本篇会用到那里的 readiness 口径。
为什么需要它
一个 12 副本的订单服务,滚动发布时单个 Pod 从 container start 到 readiness 首次通过是 4.8 秒(P50)。上游网关对它的超时是 3 秒。
这两个数字放在一起,解释了一个看起来很奇怪的现象:弹性策略长期维持 minReplicas=2,从来不缩到 0。原因很朴素——缩到 0 之后,第一个请求必然在 3 秒内等不到就绪,直接 504。
再看另外三个数:镜像 268MB,稳定态 RSS 620MB,一次全量发布 4 分 05 秒。发布窗口、缩容下限、单机成本,三件事卡在同一个地方:进程从启动到能干活要多久。
JVM 上这段时间花在三处:类加载、反射扫描与代理生成、JIT 预热。这三件事有个共同点——它们在构建期就能部分确定。AOT(Ahead-of-Time,提前编译)要做的就是把它们从运行期搬到构建期。
所以这一章要回答的不是「native 快不快」,而是:你的启动预算有多少,用什么手段兑现它,代价记在谁账上。截至 2026 年 11 月,评估基线为 Spring Boot 4.1.2、GraalVM Community 25、Native Build Tools 1.1.14,JDK 下限 17。
核心概念
AOT 处理(Ahead-of-Time Processing)
在构建期把组件扫描结果固化成 bean 定义与代理类,运行期不再读注解、不再扫类路径,这就是 AOT 处理。
类比:把「客人到店现炒」换成「中央厨房预制,到店复热」。出餐快,但菜单在开店前就定死了。
反例:以为 AOT 就等于编译成二进制。不是。AOT 处理在普通 JVM 上也能用——加 -Dspring.aot.enabled=true 运行的 jar 就跑在 JVM 里,它只是把启动期的工作提前做掉了。
封闭世界假设(Closed-World Assumption)
原生镜像编译要求:编译期能看到运行期会用到的全部类、方法、资源,运行期不允许再「发现」新东西。
反例:依赖运行期加载脚本、或者按类名字符串反射装配的规则引擎,静态分析覆盖不到。这类服务不适用原生镜像,不是配置写错了。同一个限制还会打中条件装配:@ConditionalOnProperty 控制的 Bean 在构建期就要判定完,运行期改配置不会重新装配,可变部分得下沉到配置中心。
可达性元数据(Reachability Metadata,俗称 hints)
定义:一份声明,告诉 native-image「这些类会被反射调用、这些资源会被读取、这些类型会被序列化」,否则它们会在静态分析阶段被裁掉。
反例:手改 reflect-config.json。类一重命名它就静默失效,编译不报错,运行期才炸。要补就补在 Spring 的类型安全 API 上。
AOT Cache
JDK 24 引入的机制(JEP 483),把一次训练运行里类加载与链接的结果存成归档,下次启动直接映射进来。
它不要求封闭世界假设,迁移成本比原生镜像低一个数量级,适合承接那些「想要启动收益、但不符合原生镜像准入条件」的服务。用法也是三步:训练时 -XX:AOTMode=record 记录,-XX:AOTMode=create 生成归档,运行期 -XX:AOTCache 加载。
反例:以为 AOT Cache 是原生镜像的简化版,两者要求同一套条件。不是。它跑的还是 JVM,反射、动态代理、运行期加载全都照旧可用,只是把类加载与链接的结果复用了一次。也正因如此,它的收益上限就是那 1.6 秒,到不了 0.09 秒。
启动预算与探针周期
启动预算是从 container start 到 readiness 首次通过的墙钟时间,它由两段拼成:应用自己就绪要多久,以及探针多久采一次。
反例:以为应用 90 毫秒就绪,Pod 就 90 毫秒 Ready。periodSeconds=5 时,kubelet 要等到下一个探测窗口才认账,实测 Pod 级 Ready 是 1.4 秒。这已经接近该配置下的下限,再优化应用侧没有意义,该改的是探针参数。选择路径如图 12-1 所示。
图 12-1 运行形态的选择路径,依据 12 副本服务的实测数据
同一次改造在三份产物上的差别,如表 12-1 所示。数字是 8C16G、linux/amd64 单节点、三轮取中位数的结果,不要跨环境外推。
| 指标 | JVM(JDK 25) | JVM + AOT Cache | 原生镜像 |
|---|---|---|---|
| 应用级启动 P50 | 4.8 秒 | 1.6 秒 | 0.09 秒 |
| Pod 级 Ready P50 | 4.9 秒 | 2.1 秒 | 1.4 秒 |
| 稳定态 RSS | 620MB | 596MB | 78MB |
| 镜像大小 | 268MB | 268MB | 96MB |
| 稳态吞吐(200 并发 / 10 分钟,JVM 为 100%) | 100% | 100% | 94% |
| P99 延迟 | 41ms | 41ms | 48ms |
| 运行期诊断能力 | 完整 | 完整 | 受限 |
表 12-1 三种运行形态在同一服务上的实测对比
表 12-1 最后一行要展开说。原生镜像里运行期诊断能力下降,jcmd、线程转储、堆转储的常规路径都不可用,得在构建时加 --enable-monitoring=jfr 才能拿到 JFR(JDK Flight Recorder)记录。这一项直接影响线上排障时间,必须写进风险登记,而不是验收通过就算完。至于开启 JFR 带来的性能影响,截至 2026 年 11 月只在单机做过短时验证,没做 24 小时稳态观测。
动手实践
三步走完一次构建,再补一次 hints。父 POM 用 spring-boot-starter-parent,版本全部交给它管。
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>4.1.2</version>
</parent>
<build>
<plugins>
<!-- parent 内置 native profile:串起 process-aot 与 native-image -->
<plugin>
<groupId>org.graalvm.buildtools</groupId>
<artifactId>native-maven-plugin</artifactId>
</plugin>
</plugins>
</build>预期输出(mvn -Pnative help:active-profiles):
[INFO] Active Profiles for Project 'com.example:order-api:jar:0.0.1-SNAPSHOT':
The following profiles are active:
- native (source: com.example:order-api:0.0.1-SNAPSHOT)不使用 spring-boot-starter-parent 的项目,必须自己配 Spring Boot 插件的 process-aot 目标与 Native Build Tools 的 add-reachability-metadata 目标。这是「照文档做却编不出镜像」的第一类根因,而且报错信息不会指向版本问题。
第二步,编译并校验产物。
# 1) 编译可执行文件,本机需 GraalVM Community 25 及以上
mvn -Pnative native:compile
# 2) 校验产物架构:期望 x86-64;输出 aarch64 说明是 Apple Silicon 本地编的
file target/order-api
# 3) 出 OCI 镜像。builder 内的 native-image 跟随编译 JDK
mvn -Pnative spring-boot:build-image
# 4) 换 JVM 路线:AOT 处理的 jar + AOT Cache,不受封闭世界限制
java -Dspring.aot.enabled=true -jar target/order-api.jar预期输出(节选):
Finished generating 'order-api' in 3m 40s.
target/order-api: ELF 64-bit LSB pie executable, x86-64, version 1 (SYSV), dynamically linked
Successfully built image 'docker.io/library/order-api:0.0.1-SNAPSHOT'
Started OrderApiApplication in 1.612 seconds (process running for 1.83)第 2 步值得单独写进流程。有人在 Apple Silicon 上 native:compile 成功,产物本机也能跑,CI 直接复用该产物打镜像推到 amd64 节点,容器启动即 exec format error。走 buildpacks 的路径不会暴露这个问题,因为它强制在 builder 容器内编译。两条路径「本地都能跑」,差别只在这里。
第三步,给第三方库补 hints。
@Configuration(proxyBeanMethods = false)
@ImportRuntimeHints(LegacyCodecHints.class)
class NativeSupportConfig {
}
class LegacyCodecHints implements RuntimeHintsRegistrar {
@Override
public void registerHints(RuntimeHints hints, ClassLoader classLoader) {
hints.reflection().registerType(LegacyCodec.class,
MemberCategory.INVOKE_DECLARED_CONSTRUCTORS,
MemberCategory.INVOKE_PUBLIC_METHODS);
hints.resources().registerPattern("codec/templates/**");
hints.serialization().registerType(LegacyCodec.State.class);
}
}预期输出:编译通过;不加这段 hints 时,原生镜像里调用解码接口会抛 ClassNotFoundException: codec.LegacyCodec,加了之后返回 200,且 codec/templates/** 下的模板文件能被读到。
资源路径支持通配,别逐个文件写;MemberCategory 要精确到方法级别,写得过宽会把无关方法一起留下,反而缩小不了体积。
验收口径要可复现,否则数字无法被采信:Pod 级就绪 ≤1.6 秒(10 次取中位数)、镜像 ≤120MB、稳态吞吐 ≥ JVM 基线的 90%、回滚 ≤10 分钟、META-INF/native-image 下的 hints 100% 入库、至少一条集成测试覆盖反射与序列化路径。还有一个前置约束:别一期就上多模块单体。AOT 阶段按模块串行执行,构建时长与模块数近似线性相关,试点的反馈周期会被拉长到不可接受的长度。
常见误解
很多人以为原生镜像是性能优化,其实是启动与内存优化。 实测 200 并发下稳态吞吐是 JVM 的 94%,P99 从 41ms 升到 48ms,Community 版默认的 Serial GC 在堆压力下停顿更明显。它买的是启动时间和内存下限,不买峰值能力。要峰值,做 JIT 预热与压测调参,性价比高一个数量级。
很多人以为 time ./target/order-api 量的是冷启动,其实量的是运行时长。 服务不会自己退出,time 只在进程被信号终止后返回,按一次 Ctrl-C 就多出一段毫无意义的数字。正确做法是两种口径交叉校验:Kubernetes 侧从 container start 到 readiness 首次通过的墙钟时间,以及进程内 ApplicationStartup 输出的 Started XxxApplication in N seconds。两者差超过 15% 时,先查探针配置,再查镜像拉取耗时。官方文档里那行 Started MyApplication in 0.08 seconds (process running for 0.095) 也只能作数量级参考,不能当验收值。
很多人以为本地编出来的二进制可以直接推上生产,其实架构一错就启动失败。 除了 file 校验,还有两处容易照搬:一是 JVM 的 -Xmx 与 GC 参数,原生镜像的堆上限与 GC 语义都不同,照搬的结果是压测数据全错;二是构建失败的归因,内存不足时 native-image 被 OOM killer 终止,日志停在 Analysis 阶段,没有任何异常栈,这时唯一有效的动作是给构建机加内存,不是调 buildArgs。
小结
- 原生镜像的收益集中在两处:启动时间与内存下限。判断要不要用,先看进程生命周期短不短、要不要缩容到零,而不是看「快不快」。
- 启动预算 = 应用就绪时间 + 探针采样精度。应用压到 0.09 秒,Pod 级 Ready 仍受
periodSeconds限制,停在 1.4 秒。 - 封闭世界假设是整个方案的地基。任何运行期动态加载、按类名反射的组件都会打破它,这类服务改用 AOT Cache。
- 成本的大头在构建期:按人日拆分,构建与验证占 78%,运行期运维占 22%。单模块编译 3 分 40 秒,CI 冷机 6 分 12 秒,其中 Spring AOT 阶段 22 秒;CI 缓存不覆盖
target/spring-aot就会每次全量重跑。 - 别一次性铺开。一期只挑 2 个无状态、峰值吞吐不敏感的服务试点,同时保留 JVM 镜像作为回滚目标;二期把接入成本压到 1 人日以内,压不下去就不启动三期。
回看《配置与可观测性:Profiles、Actuator 与 Micrometer》:那一章的探针与健康检查口径,在这里直接决定你测出来的启动收益是真是假。测量口径没统一,4.8 秒和 1.4 秒就不是同一件事。
相关主题
这是本类目的收尾篇。接下来不需要学新框架,而是把前面各篇的结论装进一个服务:容器与自动配置决定它怎么长起来,Web 与数据访问决定它怎么对外和对数据,安全与并发决定它怎么被调用和被压住,可观测与测试决定它出事时能不能被看见、改坏时能不能被发现,本篇决定它以什么形态交付。这五件事各写一份一页纸的判断记录,比再读十篇文档有用。