Hilt依赖注入问题：无法为ViewModel提供类致应用启动失败

问题分析 #

错误提示DataStoresProvider cannot be provided without an @Provides-annotated method，本质是Hilt找不到DataStoresProvider接口的具体实例提供者——即使你添加了实现类和@Provides方法，大概率是**@Provides方法未被Hilt扫描到**，或者依赖链的配置存在冲突。

修复步骤 #

1. 确保DataStoresProvider的提供者被Hilt识别 #

把DataStoresProvider的提供方法放在已有的Hilt模块（比如AppModule）中，并且确保模块标注了@InstallIn(SingletonComponent::class)：

@Module
@InstallIn(SingletonComponent::class)
class AppModule {
    @Singleton
    @Provides
    fun provideApplication(@ApplicationContext app: Context): Application {
        return app as Application
    }

    // 关键：添加这个方法，提供DataStoresProvider的单例实例
    @Singleton
    @Provides
    fun provideDataStoresProvider(@ApplicationContext context: Context): DataStoresProvider {
        return DataStoreProviderImpl(context)
    }
}

2. 简化DataStoreProviderImpl的构造 #

不需要给DataStoreProviderImpl的构造加@Inject，因为我们已经在@Provides方法中直接创建实例，避免额外的依赖注入层级：

class DataStoreProviderImpl(
    private val context: Context
) : DataStoresProvider {
    // 直接使用preferencesDataStore扩展函数，避免自定义扩展的潜在问题
    private val userDataStore: DataStore<Preferences> = context.preferencesDataStore(
        name = "userData_v3"
    )

    override fun userDataStore(): DataStore<Preferences> {
        return userDataStore
    }
}

3. 统一UserDataStore的注入方式 #

如果你已经给UserDataStore添加了@Inject构造，就不需要在DataStoresModule中再写provideUserDataStore方法——Hilt会自动通过构造注入创建实例：

// 保留@Inject构造即可，删除DataStoresModule中的provideUserDataStore方法
class UserDataStore @Inject constructor(
    private val dataStoresProvider: DataStoresProvider
) : ModelDataStore<UserModel>(
    dataStoresProvider.userDataStore(),
    USER_KEY
) {
    companion object {
        val USER_KEY = baseStringPreferencesKey("USER_KEY")
    }
}

如果仍要保留DataStoresModule的provideUserDataStore方法，确保参数dataStoresProvider能被Hilt正确提供（即步骤1的配置已生效）。

4. 清理缓存并重构建项目 #

Hilt的代码生成可能存在缓存问题，执行以下操作：

• 执行Build > Clean Project
• 执行Build > Rebuild Project

验证依赖链 #

最终的依赖注入链应该是：
Context → DataStoreProviderImpl（实现DataStoresProvider） → UserDataStore → UserRepositoryImpl → HomeViewModel

所有组件都通过Hilt的@Provides或@Inject构造完成依赖提供，确保没有遗漏的绑定。

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