如何在Dagger中替换公共模块依赖实现并避免多绑定异常？

当然可以搞定！这种在公共模块里保留大部分依赖，只替换个别实现的场景，Dagger早就有成熟的解决办法，完全不用放弃整个CommonActivityModule。下面给你说几个实用的方案：

方案一：用自定义限定符（Qualifier）区分绑定 #

这个方法适合你需要同时保留默认实现和替换实现的场景，通过给不同的绑定打上标记，注入时按需选择：

1. 先定义两个自定义限定符（也可以用@Named，但自定义限定符可读性更强）：

@Qualifier
@Retention(AnnotationRetention.RUNTIME)
annotation class DefaultNavigator

@Qualifier
@Retention(AnnotationRetention.RUNTIME)
annotation class ActivitySpecificNavigator

2. 修改CommonActivityModule，给默认的Navigator绑定加上@DefaultNavigator限定符：

@Module 
object CommonActivityModule { 
    @JvmStatic 
    @Provides
    @DefaultNavigator
    fun baseNavigator(activity: AppCompatActivity): Navigator = BaseNavigator(activity, SOME_STUFF) 
    // 其他公共依赖保持不变
}

3. 在SomeActivityModule里，直接绑定不带限定符的Navigator（或者给它加@ActivitySpecificNavigator），这样在当前组件中，直接注入Navigator会使用AnotherNavigator，如果需要默认的BaseNavigator，就用@DefaultNavigator Navigator：

@Module(includes = [CommonActivityModule::class]) 
interface SomeActivityModule { 
    @Binds
    fun bindAnotherNavigator(anotherNavigator: AnotherNavigator): Navigator 
    // 其他模块绑定保持不变
}

方案二：用@BindsOptionalOf实现可选默认绑定 #

如果你的需求是“有替换实现就用替换的，没有就用默认的”，可以用@BindsOptionalOf来实现这种 fallback 逻辑：

1. 先定义一个可选绑定模块：

@Module
interface OptionalNavigatorModule {
    @BindsOptionalOf
    fun optionalNavigator(): Navigator
}

2. 修改CommonActivityModule，引入这个可选模块，并在提供默认Navigator时优先使用已有的绑定，没有的话再创建默认实现：

@Module(includes = [OptionalNavigatorModule::class])
object CommonActivityModule {
    @JvmStatic
    @Provides
    fun baseNavigator(
        activity: AppCompatActivity,
        @Nullable existingNavigator: Navigator?
    ): Navigator {
        // 如果有其他模块提供了Navigator，就用它，否则用默认的BaseNavigator
        return existingNavigator ?: BaseNavigator(activity, SOME_STUFF)
    }
    // 其他公共依赖保持不变
}

3. 在SomeActivityModule里正常绑定AnotherNavigator即可，Dagger会自动优先使用这个实现：

@Module(includes = [CommonActivityModule::class]) 
interface SomeActivityModule { 
    @Binds
    fun bindAnotherNavigator(anotherNavigator: AnotherNavigator): Navigator 
    // 其他模块绑定保持不变
}

方案三：拆分公共模块，抽离可替换依赖 #

如果后续有更多依赖需要单独替换，可以把CommonActivityModule里的可替换部分拆出来，比如单独做一个DefaultNavigatorModule：

1. 拆分模块：

// 单独的默认Navigator模块
@Module
object DefaultNavigatorModule {
    @JvmStatic
    @Provides
    fun baseNavigator(activity: AppCompatActivity): Navigator = BaseNavigator(activity, SOME_STUFF)
}

// Common模块只保留不可替换的公共依赖
@Module
object CommonActivityModule {
    // 其他公共依赖的@Provides方法
}

2. 对于需要默认Navigator的组件，同时引入CommonActivityModule和DefaultNavigatorModule；对于需要替换的组件（比如SomeActivity对应的组件），只引入CommonActivityModule和SomeActivityModule即可，这样既保留了公共依赖，又替换了Navigator实现。

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