Guice模块中为同一类型绑定多个单例实例的正确方法？

错误原因 #

你遇到的"A binding to... was already configured at"错误，本质是Guice中同一个类型（这里是Truck）存在多个绑定配置，Guice无法确定使用哪一个。常见的重复来源有三种：

• Truck类带有@Inject注解的构造方法，Guice会自动为它生成默认绑定
• AutomobileModule中已经存在其他绑定Truck的代码（比如bind(Truck.class).toInstance(...)或者另一个@Provides方法）
• 项目中其他被安装的Module已经绑定了Truck

共享依赖的正确处理方式 #

1. 覆盖默认自动绑定 #

如果Truck本身有@Inject构造方法，而你想用自定义的@Provides方法提供单例实例，只需在你的@Provides方法上添加@Primary注解，告诉Guice优先使用这个绑定：

@Provides
@Singleton
@Primary
public Truck provideTruck(/* 这里传入Truck需要的依赖，比如Engine */) {
    return new Truck(engine);
}

2. 区分不同实例（绑定注解） #

如果项目中确实需要多个不同的Truck实例（比如普通卡车和重型卡车），不要重复绑定同一个无注解的Truck类型，而是用绑定注解来区分：
首先自定义一个绑定注解：

@Target({FIELD, PARAMETER, METHOD})
@Retention(RUNTIME)
@BindingAnnotation
public @interface HeavyDuty {}

然后在你的@Provides方法上标注这个注解：

@Provides
@Singleton
@HeavyDuty
public Truck provideHeavyDutyTruck(Engine heavyEngine) {
    return new HeavyDutyTruck(heavyEngine);
}

注入时也要带上对应的注解，明确指定要注入哪个实例：

@Inject
public LogisticsService(@HeavyDuty Truck truck) {
    this.truck = truck;
}

3. 移除重复绑定 #

如果是因为Module中已经存在其他绑定Truck的代码，直接删除重复的配置即可——保留你需要的那个绑定（要么是原有的，要么是你新写的@Provides方法）。

是否需要多个工厂？ #

不需要刻意创建多个工厂。Guice的@Provides方法本身就是轻量级的工厂实现，足够处理大多数单例或固定依赖的实例提供场景。只有当你需要动态创建实例（比如每次调用都生成新实例，或者需要根据外部参数创建不同实例）时，才需要考虑用工厂类，配合@AssistedInject来实现带参数的实例创建。

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