Android+Kotlin+Hilt：Kotlin单例注入Context遇未初始化错误

核心问题原因 #

Kotlin的object单例由JVM自动初始化，不属于Hilt的实例管理范畴，因此Hilt无法自动为其注入依赖。你之前尝试的直接lateinit变量、继承带@Inject的抽象类、给父类加@AndroidEntryPoint等方法失效，本质都是因为这个原因。

方案1：推荐改用Hilt管理的单例类（最符合Hilt设计） #

放弃Kotlin原生object单例，改用@Singleton注解让Hilt创建并管理实例，这样Context可以直接通过构造注入：

// 定义由Hilt管理的单例类
@Singleton
class AWSound @Inject constructor(
    private val appContext: Context // 直接注入ApplicationContext（需提前在Hilt模块提供）
) {
    fun playButtonSound() {
        // 这里使用appContext实现播放逻辑，比如：
        // val sound = MediaPlayer.create(appContext, R.raw.button_click)
        // sound.start()
    }
}

使用方式

在需要调用的地方（如Activity、ViewModel）通过@Inject获取实例：

@AndroidEntryPoint
class MainActivity : AppCompatActivity() {
    @Inject
    lateinit var soundManager: AWSound

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        // 使用soundManager.playButtonSound()
    }
}

方案2：保留Kotlin object单例（兼容原有代码结构） #

如果必须保留object单例，可通过Hilt的EntryPoint手动获取ApplicationContext来初始化单例：

1. 定义EntryPoint接口：

interface AWSoundEntryPoint {
    fun getAppContext(): Context
}

2. 在Hilt注解的Application类中初始化单例：

@HiltAndroidApp
class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        // 通过EntryPoint获取Hilt提供的ApplicationContext
        val entryPoint = EntryPointAccessors.fromApplication(
            this,
            AWSoundEntryPoint::class.java
        )
        AWSound.init(entryPoint.getAppContext())
    }
}

3. 修改AWSound单例：

object AWSound {
    private lateinit var appContext: Context

    fun init(context: Context) {
        // 保存ApplicationContext避免内存泄漏
        this.appContext = context.applicationContext
    }

    fun playButtonSound() {
        // 使用appContext实现播放逻辑
    }
}

为什么之前的尝试失败？ #

• lateinit变量直接在object中：Hilt不会自动处理非自身管理实例的依赖注入。
• 继承带@Inject Context的抽象类：object实例不由Hilt创建，Hilt不会执行成员注入。
• 父类加@AndroidEntryPoint并继承Service：Service是Android组件，和object单例的生命周期无关，无法为其注入依赖。
• 构造注入报错：Kotlinobject不允许自定义构造函数，因此无法继承需要构造参数的父类。

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