Spring Boot 4 原生镜像:数字很好看,代价得算清楚
启动时间从 3 秒降到 100 毫秒,内存砍掉 70%。这两个数字,是 GraalVM 原生镜像最常被拿出来的部分。
2026 年的 Spring Boot 4 把这件事又往前推了一步:AOT 编译流程重新设计,条件和配置的处理更完整,需要手写注册的地方比 3.x 少了一截。
但我在自己的项目上试过一圈之后,发现这笔账不能只看这两个数字。
原生镜像的代价,往往在凌晨两点才出现:一个第三方库的反射调用在构建时没有被登记,抛出来的不是能接住的异常,而是一个你接不住的错误。
这篇把账算全。
一、原生镜像到底做了什么
普通 JVM 跑 Java,是边跑边编译。字节码先加载,热点方法在运行过程中被编译成机器码,同时做内联、逃逸分析这些优化。
启动慢,是因为要先加载类、做验证、启动编译器。内存高,是因为 JVM 自己要占一块,类元数据和编译器也要占内存。
原生镜像换了一条路:在构建的时候,把整个应用编译成机器码。
类加载、字节码验证、编译这些事,全部提前到构建阶段完成。最后的产物是一个二进制文件,运行的时候不需要 JVM。
直接的好处有两个:启动从 3-5 秒降到 100 毫秒以内,内存占用降 60-80%。
但还有一个不太常被提到的代价:峰值吞吐会下降。
因为编译发生在构建时,没有运行时的热点数据指导优化,内联和逃逸分析的效果不如 JIT。大多数增删改查应用差距在 5-15%,计算密集的场景会更大。
一个反直觉的结论:如果你的服务长期运行,实例固定、跑几个月不重启,启动速度对你根本不重要。JVM 在头几十秒完成预热之后,峰值性能反而更好。
二、谁真的需要原生镜像
第一类是函数计算和 Serverless。计费细到毫秒,冷启动从 3 秒降到 100 毫秒,用户请求才有可能在函数生命周期里做完,而不是大半时间在等 JVM 启动。
扩容时新实例秒级就绪,不会出现流量已经到了、实例还在启动的空窗。
第二类是容器密度受限的环境。一个集群节点上跑二十个微服务,每个 JVM 占 300MB,光内存就要 6GB。换成原生镜像每个 60-80MB,同样的机器能多放几倍。
这条有个前提:瓶颈真的是内存,而不是 CPU。CPU 已经跑满,省内存没有意义。
第三类是启动频率高的入口服务。比如 API 网关,流量波动大、实例频繁伸缩。启动快意味着扩容响应快,内存低意味着待命成本低。
大多数长期运行的业务服务,不在这三类里。
订单服务、用户服务、后台管理系统,启动一次跑几个月,启动速度不重要。瓶颈通常在数据库读写,而不是 JVM 本身,省内存带来的收益有限。
这类服务,虚拟线程已经把并发的线程开销压下来了,原生镜像不再是必选项。
三、代价一:构建时间涨 30 倍
一次普通的 mvn package 大概 30 秒。一次原生镜像编译要 10-20 分钟。
这不是夸张,是 GraalVM 做全量静态分析、类型推导、内联和死代码消除的真实耗时。
这意味着开发迭代的速度被拖慢一个数量级。改一行代码、等编译、发现问题、再改,这个循环从 30 秒变成 15 分钟。
本地开发不可能每次都跑原生编译,日常还是跑 JVM,只在流水线或者发布时跑原生。
但这就引出了下一个问题:你日常在 JVM 上跑的测试,和在原生镜像上跑出来的行为,不完全一样。
四、代价二:反射为什么是最大的坑
原生镜像基于一个假设:构建时能看到的东西,就是运行时需要的东西。
构建时做静态分析,只打包能追踪到的类和成员。如果某个类要被加载这件事,GraalVM 在构建时看不到,那个类就不会进二进制。
问题在于 Java 生态大量使用反射。Spring 的依赖注入、Jackson 的序列化、MyBatis 的映射器代理,底层都是反射。
静态分析没办法判断,运行时通过一个字符串加载的类,到底会访问哪些成员。
五、三种错误长什么样
第一种最常见,叫 MissingReflectionRegistrationError。
通过反射调用方法,但构建时没有登记元数据,运行时就抛这个错误。它继承的是 Error,不是 Exception,普通的异常捕获接不住。
错误信息会指出具体是哪个类的哪个方法缺了登记。
第二种叫 MissingRegistrationError。用 Class.forName 找类型元数据,找不到时抛出。
Jackson 序列化时如果字段没有登记,运行时就会报错。错误信息看起来像序列化失败,实际原因是反射元数据缺失。
第三种最麻烦:构建成功、测试通过、生产环境崩溃。
Spring 的 AOT 能登记它静态分析得到的部分,第三方库的需求它管不到。构建工具不知道那些代码路径运行时会走到,它只是把没登记的成员排除了。
测试跑在 JVM 上,不走原生镜像这条路,所以全部通过。等到生产环境触发那条路径,才出问题。
六、自己的代码怎么补登记
简单的 DTO,一行注解就够:在主应用类上使用 RegisterReflectionForBinding,把需要序列化的类列进去。
复杂的场景,自己实现 RuntimeHintsRegistrar。
在里面登记反射要用的构造方法和成员,登记资源文件的路径匹配,比如 validation-rules 下面那一组 JSON,再登记需要序列化的类型。然后用 ImportRuntimeHints 把这个实现挂到配置类上。
这些登记不需要理解原理,但需要有人对「哪些类会被反射」这件事负责。
七、第三方库怎么补登记
GraalVM 提供了追踪代理。启动应用时挂上这个代理,把所有端点跑一遍,它会把反射操作记录下来,生成 JSON 元数据文件,放到 src/main/resources/META-INF/native-image 下面。
之后原生编译会自动读取这些文件。
具体做法是给 java 命令加上 agentlib 的 native-image-agent 参数,把输出目录指向前面那个位置,再运行打包出来的 order-service-0.0.1-SNAPSHOT.jar。
有一个已知限制:GraalVM 25 的追踪代理存在一个回归。
通过 AtomicReferenceFieldUpdater 或者 Unsafe.objectFieldOffset 访问的字段,代理会漏掉字段级元数据。遇到这种情况,只能手动补 JSON。
八、代价三:调试手段全废
JVM 上的诊断工具,比如 JFR、Arthas、热替换,全部依赖字节码和 JVM 的运行时结构。
原生二进制里没有这些东西。
栈信息里的行号可能对不上源码;热替换不可用,改一行代码要重新编译整个二进制;线上排查不能挂一个 Arthas 进去看运行时状态。
在原生镜像上出生产事故,排查手段基本只剩日志。
日志不够详细,就只能重新编译一个带调试信息的版本,去复现问题。
九、Spring Boot 4 改了什么
Spring Boot 4 重新设计了 AOT 编译流程,自动处理的模式比 3.x 多了一截。
条件 Bean、按配置开关的 Bean 处理得更完整;Profile 相关的配置不再需要手动登记;懒加载和对象提供器这类复杂注入,也会自动登记。
但下面这些仍然要自己处理:第三方库的反射元数据、参数在运行时才拼出来的 Class.forName、ObjectOutputStream 序列化、不归 Spring 管的动态代理、路径来自环境变量的资源文件。
一个实用的建议:在流水线里先用 JVM 模式跑一遍 AOT 校验,也就是打开 spring.aot.enabled 再启动应用。
这能在几秒内抓住大部分 AOT 层面的问题,不用每次都等 15 分钟的原生编译。
十、怎么判断要不要上
| 场景 | 建议 | 理由 |
|---|---|---|
| 函数计算、短生命周期进程 | 用 | 冷启动成本太高,原生镜像几乎是唯一选择 |
| 长期运行的业务服务 | 不用 | 虚拟线程已经解决并发问题,JIT 峰值性能更好 |
| K8s 高密度部署 | 看情况 | 瓶颈是内存就用,瓶颈是 CPU 就没有意义 |
| 团队没有 GraalVM 排错经验 | 先别上 | 出了问题没法快速定位 |
最后一条不是技术问题,是组织问题。
构建时间涨 30 倍、反射元数据要持续维护、调试手段受限,这些代价在一切顺利时感受不到,出问题时会集中爆发。
团队里没有人踩过 GraalVM 的坑,第一次上生产大概率要交学费。
十一、和虚拟线程是什么关系
这两个特性解决的不是同一个问题。
原生镜像解决启动速度和内存占用;虚拟线程解决并发模型的线程开销。
不冲突,也不互相替代。
在高并发短请求的场景里,两个特性有交集:原生镜像省内存,但峰值吞吐不如 JIT;虚拟线程吞吐高,但内存占用还是 JVM 的水平。
入口服务如果既要启动快,又要扛并发,比如流量波动大的 API 网关,这两个特性可以互补。前提是接受两份代价:原生镜像的反射元数据维护,和虚拟线程的数据库驱动兼容性。
对大多数业务服务来说,虚拟线程已经够了。原生镜像是一个更重的选择。
十二、这笔账应该怎么算
把收益和代价放在同一张纸上,算法会清楚很多。
收益这一侧有两项:启动时间省下来的等待,乘以实例启动的频率;内存省下来的用量,乘以机器的单价。
代价这一侧有四项:构建时间增加,乘以每天构建的次数;反射元数据的维护人力;调试能力的损失;峰值吞吐的下降。
对于跑几个月的业务服务,第一项收益接近零。对于按毫秒计费的函数计算,第一项收益就是全部。
所以问题不是「原生镜像好不好」,而是「你的服务靠什么赚钱」。
靠快速伸缩赚钱,值得付这份代价。靠稳定运行赚钱,这份代价大概率收不回来。
十三、如果真要上,按什么顺序
第一步,在流水线里打开 AOT 校验,用 JVM 模式跑,把大部分登记问题提前暴露。
第二步,选一个不承担核心流量、但生命周期短的服务,在预发环境跑原生镜像,观察一个完整的发布周期。
第三步,再考虑把它放到入口服务上,并且保留随时退回 JVM 的方案。
一次把所有服务都换成原生,是最贵的一种试法:构建时间、排错难度、团队学习成本会同时到来。
十四、三个常见的误解
第一个误解:原生镜像一定更快。它快在启动和内存,不在峰值吞吐。
第二个误解:内存减半,账单就减半。要看计费方式,按请求计费时,待命实例的内存省下来才有意义。
第三个误解:登记一次就永远够用。依赖升级、框架升级、代码里新加一个反射调用,都可能让元数据失效。
十五、收口
Spring Boot 4 让原生镜像更容易上手,但没有让代价消失。
它适合生命周期短、对冷启动敏感、内存是瓶颈的场景。
它不适合跑几个月不重启、瓶颈在数据库、团队没有排错经验的业务系统。
这笔账的关键,是先承认启动快只是收益的一项,然后把构建、维护、调试、吞吐这四项代价一起放上秤。
秤上的结果,比会议上的两个数字可靠。