Jetpack Compose导航UI测试集成Hilt时遇组件实现异常

核心问题本质 #

这个异常的根源是测试中使用的Activity未被Hilt正确处理——要么是Activity没加@AndroidEntryPoint注解，要么是测试环境的Hilt初始化配置缺失，导致Hilt无法识别并注入依赖。

分步排查与解决 #

1. 修正测试类的Activity启动配置 #

测试中必须启动你自己标注了@AndroidEntryPoint的MainActivity，绝对不能直接使用ComponentActivity（未被Hilt处理的默认Activity）：

@HiltAndroidTest
class NavUiTest {
    @get:Rule
    val hiltRule = HiltAndroidRule(this)

    @get:Rule
    // 必须指定你的@AndroidEntryPoint Activity
    val composeTestRule = createAndroidComposeRule<MainActivity>()

    @Before
    fun setup() {
        hiltRule.inject() // 初始化Hilt依赖注入
    }

    // 测试代码...
}

禁止使用createComposeRule()或createAndroidComposeRule<ComponentActivity>()，这两种方式会绕过Hilt的组件管理。

2. 确认HiltTestRunner的正确配置 #

• 自定义测试运行器需正确继承AndroidJUnitRunner并指定Hilt测试Application：

class HiltTestRunner : AndroidJUnitRunner() {
    override fun newApplication(
        cl: ClassLoader?,
        className: String?,
        context: Context?
    ): Application {
        // 使用Hilt提供的测试Application，无需自定义
        return super.newApplication(cl, HiltTestApplication::class.java.name, context)
    }
}

• 在模块级build.gradle.kts中配置测试运行器：

android {
    defaultConfig {
        testInstrumentationRunner "com.your.package.HiltTestRunner"
    }
}

3. 补全测试依赖 #

确保模块级build.gradle.kts中包含Hilt测试相关依赖，且版本与项目主Hilt版本一致：

dependencies {
    androidTestImplementation("com.google.dagger:hilt-android-testing:2.48")
    kaptAndroidTest("com.google.dagger:hilt-android-compiler:2.48")
}

4. 验证Application类配置 #

• 你的Application类必须标注@HiltAndroidApp：

@HiltAndroidApp
class YourApp : Application()

• 在AndroidManifest.xml中正确引用该Application：

<application
    android:name=".YourApp"
    <!-- 其他配置项 -->
>

5. 嵌套导航图的注入规范 #

导航中使用的ViewModel必须通过hiltViewModel()注入，保证Hilt能正确管理其生命周期：

// Compose导航中的ViewModel注入方式
val viewModel: YourNavViewModel = hiltViewModel()

测试时无需额外处理导航图的依赖，只要Activity和测试类的Hilt配置正确，导航组件会自动获取注入实例。

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