如何使用Guice在运行时动态替换单例对象？

完全可以实现，核心思路是不要直接注入不可变的端点配置实例本身，而是注入可感知配置变更的中间层，所有组件通过这个中间层获取最新配置实例，就能满足运行时热更新、所有组件访问时拿到新实例的要求。

为什么直接注入不可变单例做不到运行时更新 #

不可变对象本身创建后属性就无法修改，加上Guice默认的单例绑定在第一次注入后，就会把固定的对象引用分发给所有注入点，后续就算你新建了新的配置实例，已经拿到旧引用的组件根本感知不到变化，不可能自动替换成新对象。

具体实现方案 #

方案1：注入配置持有器（最简单无额外依赖） #

写一个线程安全的配置持有类绑定为单例，所有组件注入这个持有器，每次需要用配置的时候从持有器中取值，更新配置时直接替换持有器内存储的实例引用即可，完全兼容你现有的不可变端点配置设计。
示例代码：

// 保持原有不可变端点配置类的设计不变
public record EndpointConfig(String endpointUrl, int connectTimeout, int readTimeout) {}

// 线程安全的配置持有器，绑定为单例
@Singleton
public class EndpointConfigHolder {
    // 必须加volatile保证多线程下配置更新的可见性
    private volatile EndpointConfig currentConfig;

    @Inject
    public EndpointConfigHolder(EndpointConfig initialConfig) {
        this.currentConfig = initialConfig;
    }

    // 业务代码每次使用配置时调用该方法获取最新实例
    public EndpointConfig get() {
        return currentConfig;
    }

    // 配置变更时调用该方法替换实例
    public void update(EndpointConfig newConfig) {
        this.currentConfig = newConfig;
    }
}

Guice模块内正常完成绑定即可：

public class AppModule extends AbstractModule {
    @Override
    protected void configure() {
        bind(EndpointConfig.class).toInstance(loadInitialEndpointConfig());
        bind(EndpointConfigHolder.class).asEagerSingleton();
    }
}

业务侧将原来直接注入EndpointConfig的地方改成注入EndpointConfigHolder，每次调用holder.get()就能拿到最新的配置实例。

方案2：使用Guice原生Provider注入（更贴合Guice设计习惯） #

如果不想引入自定义持有器类型，可以自定义Provider<EndpointConfig>实现，内部同样用volatile字段维护最新配置实例，所有组件注入Provider<EndpointConfig>，每次调用provider.get()获取最新配置。

@Singleton
public class EndpointConfigProvider implements Provider<EndpointConfig> {
    private volatile EndpointConfig currentConfig;

    public EndpointConfigProvider(EndpointConfig initialConfig) {
        this.currentConfig = initialConfig;
    }

    @Override
    public EndpointConfig get() {
        return currentConfig;
    }

    public void update(EndpointConfig newConfig) {
        this.currentConfig = newConfig;
    }
}

模块绑定时手动维护Provider实例，方便后续触发配置更新：

@Override
protected void configure() {
    EndpointConfig initialConfig = loadInitialEndpointConfig();
    EndpointConfigProvider configProvider = new EndpointConfigProvider(initialConfig);
    bind(EndpointConfig.class).toProvider(configProvider);
    bind(EndpointConfigProvider.class).toInstance(configProvider);
}

不要依赖Guice自动创建Provider实例再从Injector中查找实例做更新，手动创建绑定的方式更直接，也避免了初始化顺序导致的空指针问题。

存量代码兼容方案（零修改原有注入点） #

如果项目中已经有大量代码直接注入EndpointConfig，不想逐个修改注入点，可以用动态代理生成配置类的代理对象，把代理对象绑定为单例注入给所有组件，代理内部每次方法调用都转发给持有的最新真实配置实例。
如果EndpointConfig是接口，直接用JDK动态代理即可：

@Override
protected void configure() {
    EndpointConfigHolder holder = new EndpointConfigHolder(loadInitialEndpointConfig());
    bind(EndpointConfigHolder.class).toInstance(holder);
    EndpointConfig proxyInstance = (EndpointConfig) Proxy.newProxyInstance(
        getClass().getClassLoader(),
        new Class[]{EndpointConfig.class},
        (proxy, method, args) -> method.invoke(holder.get(), args)
    );
    bind(EndpointConfig.class).toInstance(proxyInstance);
}

如果EndpointConfig是普通类，用ByteBuddy、CGLIB这类字节码工具生成子类代理即可，原有注入代码完全不需要改动，配置更新后所有方法调用会自动路由到新实例。

避坑提醒 #

不要尝试修改Guice单例注册表、自定义Scope强行销毁重建单例，这类方案无法更新已经注入到其他组件中的旧引用，还容易引发内存泄漏、依赖初始化顺序混乱的问题，维护成本极高。

内容的提问来源于stack exchange，提问作者user6342701