Dagger2转Hilt迁移缺失绑定：EntryPoint依赖图构建问题

问题背景 #

已经在Application类上添加@HiltAndroidApp注解，主模块AggregatorModuleApplication安装在SingletonComponent，并通过AppComponent（标注@EntryPoint且安装在SingletonComponent）完成Application的注入，App类运行正常。

现在给MainActivity添加@AndroidEntryPoint注解，自定义了MainActivityComponent（同时标注@Module、@EntryPoint且重复@InstallIn(ActivityComponent::class)），在Activity中通过EntryPointAccessors.fromActivity获取该组件时，出现错误：

error: [Dagger/MissingBinding] com.projecthilt.di.MainActivityComponent cannot be provided without an @Provides-annotated method.

同时需要处理ComponentOne这个@Subcomponent的实例获取问题。

错误原因 #

1. 注解混用与定位错误：把@Module和@EntryPoint标注在同一个接口MainActivityComponent上，这两个注解功能完全不同——@Module是用来提供依赖的，@EntryPoint是用来暴露已有组件内部依赖的，不能混用。
2. 重复冗余注解：MainActivityComponent重复写了@InstallIn(ActivityComponent::class)，属于无效冗余。
3. 组件定义逻辑错误：因为MainActivity已经加了@AndroidEntryPoint，Hilt会自动生成对应的Activity级别组件，不需要手动定义MainActivityComponent来充当"组件"，Dagger找不到这个自定义组件的提供方法，因此报MissingBinding错误。

解决步骤 #

1. 修正EntryPoint定义 #

删除MainActivityComponent上的@Module和重复的@InstallIn，并建议改名避免和组件概念混淆，只保留@EntryPoint和正确的@InstallIn：

@InstallIn(ActivityComponent::class)
@EntryPoint
interface MainActivityEntryPoint {
    // 注：@AndroidEntryPoint会自动完成Activity注入，这个inject方法可以移除
    // fun inject(activity: MainActivity)
    fun componentOneFactory(): ComponentOne.Factory
    fun componentTwo(): ComponentTwo
}

2. 修正Activity中的调用逻辑 #

使用修正后的EntryPoint接口获取依赖：

private val activityEntryPoint = EntryPointAccessors.fromActivity(this, MainActivityEntryPoint::class.java)
// 获取ComponentOne实例
val componentOne = activityEntryPoint.componentOneFactory().create()

3. 处理ComponentOne Subcomponent #

因为ComponentOne是@Subcomponent，需要在对应级别的Module中提供它的Factory：
首先给ComponentOne添加Factory接口：

@Subcomponent
interface ComponentOne {
    fun inject(fragment: FragmentX)
    fun inject(fragment: FragmentZ)
    fun inject(fragment: FragmentY)

    @Subcomponent.Factory
    interface Factory {
        // 如果需要依赖Activity级别的对象，可以在这里添加参数，Hilt会自动注入
        fun create(): ComponentOne
    }
}

然后在Activity级别的Module中暴露这个Factory：

@InstallIn(ActivityComponent::class)
@Module
interface ActivityModule {
    @Subcomponent.Factory
    fun componentOneFactory(): ComponentOne.Factory
}

额外注意事项 #

• 不要在同一个接口上混用@Module和@EntryPoint，两者职责完全不同。
• 使用@AndroidEntryPoint后，Hilt会自动生成对应组件，无需手动定义组件接口，仅需通过@EntryPoint暴露需要的依赖或Subcomponent Factory。
• 原AppComponent中的mainActivityComponent()方法可以移除，因为@AndroidEntryPoint已经和ActivityComponent绑定，无需从AppComponent获取。

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