从Dagger2迁移到Hilt后，类无法找到@Named注解的Hilt Provider？

可能原因及对应解决办法 #

1. Hilt模块未正确安装到组件 #

你的HiltApplicationModule必须同时添加@Module和@InstallIn注解，否则Hilt不会将该模块纳入全局依赖图。示例代码：

@Module
@InstallIn(SingletonComponent::class) // 绑定到Application级单例组件
object HiltApplicationModule {
    @Provides
    @Named("config_service_merchant")
    fun provideConfigService(): ConfigService {
        // 实现逻辑
    }

    // 其他Provider方法
}

若缺少@InstallIn注解，Hilt无法识别模块内的Provider方法，自然找不到对应依赖。

2. @Named注解字符串不匹配 #

仔细核对两处的@Named值：

• Provider方法上的@Named("config_service_merchant")
• AnalyticsConfig中注入ConfigService时的@Named注解内容

只要存在大小写、下划线、拼写差异，Hilt就会判定为不同依赖，导致找不到Provider。比如把config_service_merchant写成Config_Service_Merchant或configservice_merchant都会触发错误。

3. 残留Dagger2代码导致依赖图冲突 #

若项目中仍保留旧的Dagger2组件（@Component/@Subcomponent），可能出现以下问题：

• AnalyticsConfig仍由旧Dagger2组件管理，而ConfigService的Provider仅存在于Hilt模块中，Dagger2组件无法识别Hilt模块，因此报错。
• 旧Dagger模块中存在同名但配置错误的ConfigService Provider，与Hilt模块产生冲突。

解决办法：

• 彻底移除所有旧Dagger2组件类、未被Hilt接管的模块类
• 确保所有需要注入的页面（如你的单Activity）添加@AndroidEntryPoint注解，Application类添加@HiltAndroidApp注解，让Hilt完全接管依赖注入逻辑

4. AnalyticsConfig的注入逻辑异常 #

检查AnalyticsConfig的注入方式：

• 若为构造注入，确保构造函数添加@Inject注解，且依赖的ConfigService正确添加@Named("config_service_merchant")注解：

class AnalyticsConfig @Inject constructor(
    @Named("config_service_merchant") private val configService: ConfigService
) {
    // 类逻辑
}

• 若AnalyticsConfig通过模块提供，确保对应模块添加@Module和@InstallIn注解，且依赖的ConfigService引用正确。

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