Java 25 里 Stable Values 进入预览,很多团队第一反应是:这不就是懒加载吗?是,但它解决的是我们在生产代码里反复手写、反复 review、反复踩坑的一类问题:一次性初始化、线程安全发布、启动成本和首次请求延迟之间的取舍。
本文适用于 Java 25 预览特性评估、Spring Boot 后端服务、昂贵客户端懒初始化、启动性能治理。OpenJDK JEP 502 和 JDK 25 资料只用于核对事实,正文按生产落地复盘写,不搬官方 API 说明。

业务场景:启动快了,首次请求却被客户端初始化打爆
一个订单服务启动时会初始化规则引擎、远程定价客户端、证书解析器和几个大配置对象。全放启动阶段,发布窗口变长;全放首次请求,第一波流量就会抖。以前我们常用 holder class、volatile 双重检查锁,或者自己包一层 Supplier。
这些方案都能工作,但团队代码里一多,就会出现锁粒度不一致、异常语义不清、初始化函数有副作用、失败后到底重试还是缓存失败等问题。Stable Values 的价值在这里:把“一次性懒初始化”的并发语义交给 JDK,让业务代码少写一点自制并发工具。
先说边界:预览 API 不能直接当默认方案
Stable Values 在 Java 25 是预览特性,编译和运行都要显式启用 preview。这意味着它适合技术预研、内部服务灰度、性能敏感路径验证;不适合在没有版本治理的基础库里直接扩散。
我会优先挑三类对象试:创建成本高、只需要初始化一次、初始化失败可观测。比如远程服务客户端、只读配置解析结果、预热后的规则表。普通常量、轻量对象、每次请求都不同的上下文,不要硬套。

代码案例:把 DCL 改成更清楚的懒初始化
双重检查锁不是不能用,问题是每个工程师都写一遍,就会把并发细节散落在业务代码里。Stable Values 让“只初始化一次并安全发布”的意图更直接。

踩坑原因:懒加载最怕副作用不受控
初始化函数里如果会注册监听器、打开连接、写本地文件、申请分布式锁,就必须定义失败后的行为。失败是否允许重试?半初始化资源怎么清理?日志里能不能看到耗时和异常类型?这些问题和用不用 Stable Values 无关,但新 API 会让它们更容易被忽略。
我的做法是把初始化函数写成幂等,内部记录耗时和异常摘要,必要时加启动后预热任务。不要等第一个真实用户请求来替你试初始化。
上线检查清单
- 确认运行环境是 Java 25,并且编译、测试、运行链路都显式启用 preview。
- 初始化对象是否只读或线程安全,是否真的只需要初始化一次。
- 初始化失败是否可观测,是否有重试、降级或快速失败策略。
- 是否对比启动耗时、首次请求 p99、内存占用和 JFR 初始化热点。
- 基础库是否允许使用预览 API,是否有回退到 holder/DCL 的分支。
- 代码 review 是否禁止在初始化函数里做不可控副作用。
我的经验
Stable Values 不是为了替换所有懒加载写法,而是给“昂贵、一次性、需要安全发布”的对象一个更清晰的表达。生产里真正要管的不是 API 名字,而是初始化时机、失败语义、观测指标和版本约束。