Hilt无法找到Service，Dagger转Hilt配置及多模块适配问题咨询

一、找不到Service的问题修复 #

你当前的问题核心原因是：依附于加了@AndroidEntryPoint注解的Activity的Fragment，也需要添加@AndroidEntryPoint注解才能触发Hilt的依赖注入流程。未加注解的Fragment无法关联Hilt组件树，自然拿不到你在FragmentComponent、SingletonComponent中定义的依赖。直接给用到依赖的Fragment添加@AndroidEntryPoint注解即可解决问题。

二、内置组件适用场景说明 #

ApplicationComponent是Hilt早期版本的命名，从Dagger 2.31版本开始已正式更名为SingletonComponent，两者功能完全一致，仅命名有差异，各常用内置组件的适用场景如下：

• SingletonComponent（原ApplicationComponent）：生命周期与App进程完全绑定，从App启动到进程销毁一直存在，适合存放全局单例依赖，比如你当前定义的Retrofit、OkHttpClient、全局配置类等，对应作用域注解为@Singleton
• ActivityComponent：生命周期与单个Activity绑定，随Activity创建生成、销毁回收，适合存放仅该Activity及其下属Fragment共享的依赖，对应作用域注解为@ActivityScoped
• FragmentComponent：生命周期与单个Fragment绑定，适合存放仅当前Fragment使用的依赖，对应作用域注解为@FragmentScoped
• ViewModelComponent：生命周期与单个ViewModel绑定，ViewModel存活期间组件一直存在，适合存放ViewModel专属的依赖，对应作用域注解为@ViewModelScoped
• ServiceComponent：生命周期与单个Service绑定，对应作用域注解为@ServiceScoped

三、功能独立Component的实现方案 #

原生Dagger中按功能拆分独立Component的需求，在Hilt中有两种实现方式：

1. 内置组件+功能拆分Module（优先推荐） #

绝大多数场景不需要自定义Component，直接将对应功能的Module安装到对应生命周期的内置组件即可实现等效能力：

• 全局生效的功能模块，将对应Module安装到SingletonComponent
• 仅特定页面流程生效的功能（比如登录流程），将对应Module安装到对应页面的ActivityComponent或FragmentComponent
• 仅ViewModel使用的功能依赖，将对应Module安装到ViewModelComponent
  该方案不需要手动管理组件的创建、销毁逻辑，Hilt会自动完成生命周期绑定，完全可以覆盖常规多模块功能拆分的需求。

2. 自定义Hilt组件（仅特殊场景使用） #

如果确实需要完全独立、和内置组件生命周期隔离的自定义组件，可以通过@DefineComponent注解实现，示例代码如下：

// 1. 定义自定义组件，指定父组件以继承父组件的依赖能力
@DefineComponent(parent = SingletonComponent::class)
interface LoginComponent {
    // 定义组件Builder，用于创建组件实例
    @DefineComponent.Builder
    interface Builder {
        fun build(): LoginComponent
    }
}

// 2. 将功能Module安装到自定义组件
@Module
@InstallIn(LoginComponent::class)
object LoginModule {
    fun provideLoginUseCase(): LoginUseCase = LoginUseCase()
}

// 3. 定义入口点，用于获取自定义组件的Builder实例
@EntryPoint
@InstallIn(SingletonComponent::class)
interface LoginComponentEntryPoint {
    fun loginComponentBuilder(): LoginComponent.Builder
}

// 使用时创建自定义组件实例
val entryPoint = EntryPoints.get(applicationContext, LoginComponentEntryPoint::class.java)
val loginComponent = entryPoint.loginComponentBuilder().build()
// 从创建的组件实例中获取对应依赖
val loginUseCase = loginComponent.provideLoginUseCase()

该方案逻辑和原生Dagger自定义Component完全一致，适合需要手动控制组件生命周期、和其他功能模块完全隔离的特殊场景。

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