Compose+Hilt导航UI测试抛出IllegalStateException问题求助

这个异常的核心原因是：UI测试中使用的默认Compose测试Activity（ComponentActivity）没有集成Hilt组件支持，而hiltViewModel()需要从Hilt的依赖容器中获取ViewModel实例，因此触发IllegalStateException。真机/模拟器运行正常是因为你的主Activity已添加@AndroidEntryPoint注解具备Hilt支持，但测试环境未配置对应兼容的Activity。

步骤1：替换Compose测试规则为Hilt兼容版本 #

把普通的createComposeRule()替换为createAndroidComposeRule<HiltTestActivity>()，该规则会创建自带Hilt支持的测试Activity。

修改测试配置中的规则定义：

@HiltAndroidTest
class ProposeNewGoalNavigationTests {
    lateinit var navController: TestNavHostController
    // 替换为Hilt兼容的Compose测试规则
    @get:Rule
    val composeTestRule = createAndroidComposeRule<HiltTestActivity>()
    @get:Rule
    var hiltRule = HiltAndroidRule(this)
    
    @BindValue
    val category1FormVM = Category1OneTimeOrRecurringViewModel()
    //其他ViewModel绑定省略

    @Before
    fun setupNavHost() {
        hiltRule.inject()
        composeTestRule.setContent {
            // 使用测试Activity的上下文初始化导航控制器
            navController = TestNavHostController(composeTestRule.activity)
            navController.navigatorProvider.addNavigator(DialogNavigator())
            navController.navigatorProvider.addNavigator(ComposeNavigator())
            
            GoalsNav(
                goalsViewModel = goalViewModel,
                proposeNewGoalViewModel = proposeNewGoalScreenViewModel,
                navController = navController,
                popBackStack = {},
                navigateToAccounts = {},
                navigateToMyTeamMessage = {},
                fragmentNavController = rememberNavController()
            )
        }
    }
}

步骤2：确保导航参数传递正确（关键） #

测试中导航到目标路由时必须传递正确的PROPOSE_GOAL_TYPE_ARG参数，否则proposeNewGoal会为null，进入默认分支的强转逻辑可能引发额外问题。测试用例中导航代码示例：

@Test
fun navigateToCategory1GoalScreen() {
    // 导航到目标路由并传递对应参数
    navController.navigate("$FILL_OUT_PROPOSED_NEW_GOAL_ROUTE/${GoalType.CATEGORY_1.typeValue}")
    // 后续断言逻辑
}

步骤3：ViewModel强转的安全优化（可选） #

为避免类型转换异常，建议添加类型检查：

val proposeNewGoalViewModelForForm = when (proposeNewGoal?.category) {
    Category.CATEGORY_1_SINGLE_OR_REOCCURRING -> {
        requireNotNull(hiltViewModel(backStackEntry) as? Category1OneTimeOrRecurringViewModel) {
            "Expected Category1OneTimeOrRecurringViewModel"
        }
    }
    // 其他分支省略
    null -> requireNotNull(hiltViewModel(backStackEntry) as? Category1OneTimeOrRecurringViewModel) {
        "Default ViewModel mismatch"
    }
}

额外注意事项 #

• 仅子类ViewModel需要添加@HiltViewModel注解，抽象类无需添加（你之前将抽象类改为带注解的open类是多余操作）。
• 测试类中@BindValue绑定的ViewModel实例要与路由对应类型一致，避免注入错误实例。

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