Skip to content

进阶: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原生镜像
应用级启动 P504.8 秒1.6 秒0.09 秒
Pod 级 Ready P504.9 秒2.1 秒1.4 秒
稳定态 RSS620MB596MB78MB
镜像大小268MB268MB96MB
稳态吞吐(200 并发 / 10 分钟,JVM 为 100%)100%100%94%
P99 延迟41ms41ms48ms
运行期诊断能力完整完整受限

表 12-1 三种运行形态在同一服务上的实测对比

表 12-1 最后一行要展开说。原生镜像里运行期诊断能力下降,jcmd、线程转储、堆转储的常规路径都不可用,得在构建时加 --enable-monitoring=jfr 才能拿到 JFR(JDK Flight Recorder)记录。这一项直接影响线上排障时间,必须写进风险登记,而不是验收通过就算完。至于开启 JFR 带来的性能影响,截至 2026 年 11 月只在单机做过短时验证,没做 24 小时稳态观测。

动手实践 ​

三步走完一次构建,再补一次 hints。父 POM 用 spring-boot-starter-parent,版本全部交给它管。

xml
<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 目标。这是「照文档做却编不出镜像」的第一类根因,而且报错信息不会指向版本问题。

第二步,编译并校验产物。

bash
# 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。

java
@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 与数据访问决定它怎么对外和对数据,安全与并发决定它怎么被调用和被压住,可观测与测试决定它出事时能不能被看见、改坏时能不能被发现,本篇决定它以什么形态交付。这五件事各写一份一页纸的判断记录,比再读十篇文档有用。