本文解析guice中@singleton+@provides方法被多次调用的根本原因，指出静态injector误初始化、构造函数重复执行等常见陷阱，并提供线程安全、符合di规范的库初始化最佳实践。
本文解析guice中@singleton+@provides方法被多次调用的根本原因，指出静态injector误初始化、构造函数重复执行等常见陷阱，并提供线程安全、符合di规范的库初始化最佳实践。
在使用 Guice 进行依赖注入时，@Singleton 与 @Provides 组合本应确保方法仅执行一次、实例全局唯一。但当将 Guice 库封装为跨框架（如 Spring）可复用的组件时，若初始化逻辑设计不当，极易破坏单例语义——正如问题所示：日志中“Bean getting created”被打印三次，表明 Library 构造函数被反复调用，进而触发多次 createInjector()，最终导致 @Provides @Singleton 方法被多次执行。
根本问题在于 初始化逻辑与 DI 生命周期错位：
- ❌ 错误模式：每次调用 Library.initializeLib(...) 都新建 Library 实例 → 每次都执行构造函数 → 每次都重建 injector（即使静态字段已存在）→ injector.getInstance(...) 总是基于新 injector，无法复用单例；
- ❌ 逻辑漏洞：if (Objects.nonNull(injector)) 判断条件相反（应为 isNull 才创建），且未加同步，存在竞态风险；
- ❌ 语义混淆：“Bean getting created” 日志实际记录的是 injector 创建，而非目标 bean 实例化，严重误导调试。
✅ 正确做法：将 injector 初始化与 Library 实例解耦，确保全局唯一、惰性且线程安全
public final class Library {
private static volatile Injector injector;
// 私有构造，禁止外部实例化
private Library() {}
// 惰性、双重检查锁定的 injector 初始化
private static Injector getInjector(LibraryModule module) {
if (injector == null) {
synchronized (Library.class) {
if (injector == null) {
injector = Guice.createInjector(module);
}
}
}
return injector;
}
public static SomeExposedComponent initializeLib(SomeClass someClass) {
// 注意：此处不应传入 someClass 到 injector 创建阶段，
// 而应通过 Module 绑定或 Provider 处理运行时依赖
Injector injector = getInjector(new LibraryModule());
return injector.getInstance(SomeExposedComponent.class);
}
}同时，在 Guice 模块中，应避免在 @Provides @Singleton 方法中调用外部初始化逻辑：
public class ServiceModule extends AbstractModule {
@Override
protected void configure(Binder binder) {}
@Provides
@Singleton
public SomeExposedComponent provideSomeExposedComponent(
SomeClass someClass,
Library library // 注入已初始化的 Library 工具类（非必需）
) {
// ✅ 正确：依赖由 Guice 自动注入，不主动触发 initializeLib
// 若 SomeExposedComponent 构造需 someClass，应在 LibraryModule 中声明 binding
return new SomeExposedComponent(someClass); // 或由 injector 管理
}
}⚠️ 关键注意事项：
- 不要在 @Provides 方法内调用 Library.initializeLib(...) —— 这绕过了 Guice 的实例管理，使 @Singleton 失效；
- 运行时参数（如 SomeClass）应通过 Guice 绑定传递，例如在 LibraryModule 中定义 bind(SomeClass.class).toInstance(someClass)，或使用 Provider<SomeClass>；
- 跨框架集成时，推荐将 Guice injector 封装为独立服务，Spring 侧通过 @Bean 委托调用，而非混用 @Provides；
- 务必校验 injector 初始化条件：if (injector == null)，而非 nonNull；并采用 volatile + 双重检查保证线程安全。
总结：Guice 的 @Singleton 保障的是 同一 injector 内 的单例。任何绕过 injector 直接 new 实例、重复创建 injector、或在 provider 中手动触发初始化的行为，都会破坏这一契约。正确的解法是——让 injector 成为真正全局、惰性、线程安全的单点入口，所有 bean 获取均统一经由该 injector 完成。
