Java 25 稳定值接口为什么会因循环依赖抛 IllegalStateException：依赖图与强可达边界

线上配置组件偶尔在第一次请求时直接抛出 IllegalStateException，排查后发现并不是多个线程同时初始化，而是两个 StableValue 互相等待对方的内容。Java 25 的 StableValue 适合表达“只设置一次”的惰性状态，但它不会替你修复循环依赖。

StableValue 的关键约束是：每个值最多成功设置一次；orElseSet 可以把一次性初始化和并发竞态收在一起，但初始化图必须保持无环。

变化先看清：StableValue 不是普通可变缓存

StableValue 是 Java 25 的预览 API。它保存一个最多设置一次的内容：可以先用 StableValue.of() 建立空容器，再通过 trySet、setOrThrow 或 orElseSet 写入；读取时则使用 orElseThrow、orElse 或再次调用 orElseSet。

这和普通的 Map 缓存有一个很实际的差别：稳定值没有“刷新”或“删除已设置内容”的操作。它表达的是初始化完成后保持不变的状态，而不是随时可替换的缓存条目。

为什么两个 supplier 会绕成一个圈

下面的代码把依赖关系缩小到两个组件。FOO 负责创建 Foo，BAR 负责创建依赖 FOO.get() 的 Bar。只要 Foo 的构造过程又回头访问 BAR.get()，依赖图就不再是树。

final class Components {
    static final Supplier FOO = StableValue.supplier(Foo::new);
    static final Supplier BAR = StableValue.supplier(() -> new Bar(FOO.get()));

    static final class Foo {
        Foo() {
            BAR.get(); // 形成 Foo -> Bar -> Foo 的回路
        }
    }

    static final class Bar {
        Bar(Foo foo) {}
    }
}

第一次调用 BAR.get() 时，BAR 尚未设置，于是 supplier 开始创建 Bar。创建 Bar 需要先取 FOO.get()；而 Foo 构造器又调用 BAR.get()，这次访问回到了仍在计算的稳定 supplier。这个回路无法得到一个先完成的起点，最终会以 IllegalStateException 结束。

把初始化图改成单向依赖

修复的重点不是给 get() 外面加一层捕获，而是让对象构造依赖一个已经存在的输入，或者把共享依赖提升到第三个不回访下游的组件。比如让 Foo 不在构造器里访问 BAR，由业务入口在拿到两个对象后再执行组合动作。

final class Components {
    static final Supplier FOO = StableValue.supplier(Foo::new);
    static final Supplier BAR = StableValue.supplier(() -> new Bar(FOO.get()));

    static Bar bar() {
        return BAR.get();
    }

    static void useBoth() {
        Foo foo = FOO.get();
        Bar bar = BAR.get();
        // 组合动作放在初始化完成之后
        use(foo, bar);
    }

    static void use(Foo foo, Bar bar) {}
}

这里的“单向”不是要求所有调用都排成固定步骤，而是要求 supplier 的计算图没有回边。并发访问时，StableValue.supplier 仍然可以负责把同一个输入的计算结果稳定下来；设计者要负责的是不要在计算期间再次进入自己或自己的上游。

并发只解决一次写入，不解决对象设计

多个线程同时调用 orElseSet 时，竞争中的 supplier 最多只有一个成功完成，其他调用会等到稳定值完成后观察已经设置的内容。这个保证可以避免“两个线程都把结果写进去”，但不能消除 supplier 内部的外部副作用，也不能把一个有环的对象图变成无环。

如果初始化动作会打开文件、建立连接或注册监听器，应让这些动作具备清晰的失败清理策略。尤其不要把“创建下游对象”和“下游对象反过来找上游对象”放在彼此的 supplier 中。

强可达意味着不能把它当作可失效缓存

StableValue 的内容设置后会保持强可达，直到持有它的稳定值本身被回收。一个单例组件若把大字典、连接上下文或请求级对象塞进稳定值，就可能让这些对象跟随单例存活很久。

因此它更适合不可变配置、类级元数据和真正只初始化一次的共享对象。需要按租户、版本或时间窗口淘汰的内容，应该使用有明确失效策略的缓存，而不是把 StableValue 当成带刷新按钮的容器。

排查 IllegalStateException 的三个落点

先画 supplier 的调用边界

从抛错的 get() 或 orElseSet() 开始，记录它正在计算哪个稳定值，再沿 supplier 中的访问继续追踪。遇到已经在本次调用链上出现过的稳定值，优先按循环依赖处理。

区分竞争与回路

竞争通常表现为多个线程围绕同一个稳定值等待后返回同一内容；回路则是初始化链回到尚未完成的同一个节点。不要看到“并发”就先加锁，锁可能只会把回路隐藏成更难读的等待。

检查内容是否真的应该永久保留

如果对象需要替换、关闭、按键淘汰或按请求隔离，StableValue 的一次性语义就不合适。先明确对象的生命周期，再决定使用稳定值、普通缓存还是显式工厂。

相关问题

StableValue 是不是线程安全缓存？

它提供线程安全的一次性设置语义，但不是带过期、删除和容量管理的通用缓存。缓存策略仍需要单独设计。

循环依赖一定在启动时就报错吗？

不一定。StableValue 支持惰性计算，循环可能直到第一次访问某个 supplier 时才暴露。

捕获 IllegalStateException 能修复依赖问题吗？

不能。捕获只能改变错误呈现方式，真正的修复是拆开回路、注入已构造依赖或把组合动作移到初始化之后。

小结

StableValue 的价值在于把“只设置一次”的状态交给运行时表达，并为惰性初始化提供并发保证。它的边界也同样明确：supplier 之间要保持无环，内容一旦设置就会长期保持强可达。把依赖图和对象生命周期先画清楚，才能让 Java 25 的这个预览 API 真正降低复杂度。