Dagger Hilt报错：CoroutineDispatcher缺少绑定的排查求助

核心问题分析 #

1. 组件层级不匹配：CoroutineModule安装在ViewModelComponent，但RepositoryModule安装在SingletonComponent。Hilt组件层级遵循「Singleton → ActivityRetained → ViewModel」的顺序，上层组件无法访问下层组件提供的依赖，因此SingletonComponent找不到CoroutineDispatcher的提供方法。
2. 注解不匹配：RepositoryModule的provideWeatherRepository方法中，defaultDispatcher参数未添加@IoDispatcher注解，与WeatherRepository构造器要求的@IoDispatcher注入标识不对应。

修复步骤 #

步骤1：调整CoroutineModule的安装范围 #

将CoroutineModule的安装组件改为SingletonComponent，让所有层级的组件都能访问Dispatcher依赖：

@Module
@InstallIn(SingletonComponent::class) // 替换原ViewModelComponent
object CoroutineModule {

    @DefaultDispatcher
    @Provides
    fun provideDefaultDispatcher(): CoroutineDispatcher = Dispatchers.Default

    @IoDispatcher
    @Provides
    fun provideIODispatcher(): CoroutineDispatcher = Dispatchers.IO

    @MainDispatcher
    @Provides
    fun provideMainDispatcher(): CoroutineDispatcher = Dispatchers.Main

    @MainImmediateDispatcher
    @Provides
    fun providesMainImmediateDispatcher(): CoroutineDispatcher = Dispatchers.Main.immediate
}

步骤2：修正RepositoryModule的参数注解 #

在provideWeatherRepository的Dispatcher参数上添加@IoDispatcher，与Repository构造器的注入要求对齐：

@Module
@InstallIn(SingletonComponent::class)
object RepositoryModule {

    @Singleton
    @Provides
    fun provideWeatherRepository(weatherService: WeatherService, @IoDispatcher dispatcher: CoroutineDispatcher) =
        WeatherRepository(weatherService, dispatcher)
}

步骤3：验证依赖一致性 #

WeatherRepository构造器已正确标注@IoDispatcher，无需修改：

class WeatherRepository @Inject constructor(
    private val weatherService: WeatherService,
    @IoDispatcher private val dispatcher: CoroutineDispatcher
)

修复原理 #

• Hilt组件的依赖可见性是单向的：下层组件可访问上层依赖，上层组件无法访问下层依赖。将CoroutineModule移至SingletonComponent后，所有组件均可获取Dispatcher实例。
• 同类型依赖需通过限定符（Qualifier）明确区分，否则Dagger无法识别具体要注入的实例，从而抛出MissingBinding错误。

内容的提问来源于stack exchange，提问作者DJ-DOO