Android Hilt：将应用单例注入非Android类及构造函数注入报错问题解决

这个问题我之前也碰到过，核心是没搞清楚Hilt管理实例的规则，咱们一步步拆解解决：

先说说你遇到的直接错误原因 #

你调用UserManager(true)时出现类型不匹配的错误，是因为UserManager的构造函数第一个参数是SomeManager类型，但你直接传了布尔值true——这是语法层面的问题。但更深层的问题是：带有@Inject构造函数的类，绝对不能手动通过构造调用（比如UserManager(...)）来创建实例，因为Hilt需要负责注入它的依赖（比如这里的SomeManager单例），手动创建的话Hilt完全没法介入，既没法帮你注入依赖，也违反了Hilt的使用规范。

正确实现的两种方案 #

方案1：让UserManager也由Hilt管理（适合需要复用单例的场景） #

如果UserManager本身也需要是应用级单例，直接给它加上@Singleton注解，让Hilt统一管理：

@Singleton
class UserManager @Inject constructor(
    private val someManager: SomeManager,
    private val isValid: Boolean = false
) { .... }

之后，在任何需要使用UserManager的地方（不管是Android类还是其他被Hilt管理的非Android类），都通过@Inject来获取实例：
比如在Activity中：

@AndroidEntryPoint
class MainActivity : AppCompatActivity() {
    @Inject lateinit var userManager: UserManager

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        // 直接使用userManager即可，Hilt已经帮你注入了SomeManager和默认的isValid=false
    }
}

如果是在另一个被Hilt管理的非Android类中，同样用@Inject注入：

@Singleton
class AnotherManager @Inject constructor(
    private val userManager: UserManager
) { .... }

方案2：用辅助注入（Assisted Injection）手动传入参数（适合需要动态传参的场景） #

如果UserManager不需要是单例，而是需要动态传入isValid参数，同时还要让Hilt注入SomeManager，这时候就需要用到Hilt的辅助注入功能：

1. 首先确保你的项目添加了辅助注入的依赖（在Module级别的build.gradle中）：

implementation "com.google.dagger:hilt-android:2.48"
kapt "com.google.dagger:hilt-android-compiler:2.48"
implementation "androidx.hilt:hilt-common:1.1.0"
kapt "androidx.hilt:hilt-compiler:1.1.0"

2. 修改UserManager的构造，用@Assisted标注需要手动传入的参数，同时定义一个@AssistedFactory接口：

class UserManager @AssistedInject constructor(
    private val someManager: SomeManager,
    @Assisted private val isValid: Boolean
) {
    // 定义工厂接口，用于创建实例
    @AssistedFactory
    interface Factory {
        fun create(isValid: Boolean): UserManager
    }
}

3. 在需要创建UserManager的地方，注入UserManager.Factory，然后通过工厂创建实例：
   比如在Activity中：

@AndroidEntryPoint
class MainActivity : AppCompatActivity() {
    @Inject lateinit var userManagerFactory: UserManager.Factory

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        // 动态传入isValid参数，Hilt自动注入SomeManager
        val userManager = userManagerFactory.create(true)
    }
}

如果是在非Android类中创建，只要这个类是被Hilt管理的（比如带有@Inject构造），同样可以注入UserManager.Factory来创建实例。

必须确认的基础配置 #

最后别忘了，Hilt的核心配置不能少：你的Application类必须添加@HiltAndroidApp注解，这是Hilt初始化的入口：

@HiltAndroidApp
class MyApp : Application() { ... }

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