使用Hilt实现Clean Architecture时遇依赖注入错误求助

核心问题分析 #

你遇到的两个错误根源都是Hilt作用域不匹配+依赖缺失：

1. 最初的ClassCastException：把SingletonComponent（绑定Application生命周期）换成ActivityComponent是正确的调整，但后续出现的cannot be provided without an @Provides-annotated method错误，是因为：
   • @Singleton注解仅能用于SingletonComponent，和ActivityComponent的作用域不兼容，Hilt无法识别跨作用域的注解。
   • 依赖链中缺少Retrofit的实例提供方法，Hilt找不到Retrofit来创建ProfileApiService。

具体修复步骤 #

1. 修正作用域注解 #

将所有@Singleton替换为@ActivityScoped（与ActivityComponent的生命周期匹配）：

@Module
@InstallIn(ActivityComponent::class)
class ProfileDetailModule {

    @ActivityScoped
    @Provides
    fun providesProfileDetailRepository(dataSource: ProfileDataSource): ProfileRepository {
        return ProfileRepositoryImpl(dataSource)
    }

    @ActivityScoped
    @Provides
    fun providesProfileDataSource(profileApiService: ProfileApiService): ProfileDataSource {
        return ProfileDataSource(profileApiService)
    }

    @ActivityScoped
    @Provides
    fun providesProfileDetailApiService(retrofit: Retrofit): ProfileApiService =
        retrofit.create(ProfileApiService::class.java)
}

2. 添加Retrofit实例提供方法 #

Hilt无法自动创建Retrofit，需要补充对应的@Provides方法。建议单独创建一个全局的网络Module：

@Module
@InstallIn(SingletonComponent::class) // Retrofit建议全局单例，绑定Application生命周期
object NetworkModule {
    @Singleton
    @Provides
    fun provideRetrofit(): Retrofit {
        return Retrofit.Builder()
            .baseUrl("https://jsonplaceholder.typicode.com/")
            .addConverterFactory(GsonConverterFactory.create())
            .build()
    }
}

3. 移除冗余的嵌套AppModule #

你嵌套的AppModule提供Activity的写法完全冗余，直接在需要的地方通过@Inject @ActivityContext val activity: Activity注入即可，无需额外提供。

4. 确保ViewModel的Hilt配置 #

ProfileDetailViewModel必须添加@HiltViewModel注解，才能让Hilt注入GetUserProfile：

@HiltViewModel
class ProfileDetailViewModel @Inject constructor(
    private val getUserProfile: GetUserProfile
) : ViewModel() {
    // 你的ViewModel业务逻辑
}

5. 确认Application的Hilt入口配置 #

避免再出现最初的ClassCastException，必须给自定义Application类添加@HiltAndroidApp注解：

@HiltAndroidApp
class MyApplication : Application() {
    // 空实现即可
}

同时在AndroidManifest.xml中指定该Application：

<application
    android:name=".MyApplication"
    <!-- 其他原有配置 -->
>

额外优化建议 #

• GetUserProfile继承MutableLiveData的设计不合理，建议将LiveData的持有逻辑放在ViewModel中，UseCase仅负责纯业务逻辑并返回数据。
• 你在getUser方法中直接拼接URL的方式容易出错，建议改用Retrofit的路径参数或查询参数来构建请求地址。

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