Android NavController UI测试：performClick执行后页面未跳转问题排查

我来帮你梳理几个实用的排查方向，这类Jetpack Compose导航测试的问题其实挺常见的：

1. 确认测试用的导航控制器是否正确 #

普通的NavController在测试环境里可能无法正常工作，你需要改用TestNavHostController来模拟导航行为。测试初始化时要确保传入的是这个测试专用的控制器，比如：

val navController = TestNavHostController(applicationContext)
// 绑定测试控制器到Compose内容
composeTestRule.setContent {
    MyAppNavHost(navController = navController)
}

如果用了普通的NavController，导航动作可能在测试环境里不会被正确分发。

2. 验证按钮的定位是否准确 #

有时候composeTestRule.activity.getString(R.string.continue_button)拿到的字符串和按钮实际的contentDescription可能不匹配（比如多语言、上下文差异）。你可以先简化测试，直接用文本定位按钮试试：

composeTestRule.onNodeWithText("下一步").assertIsDisplayed().performClick()

如果这样能触发跳转，说明是contentDescription的匹配问题，你可以打印出getString的结果，对比按钮实际设置的内容。

3. 给测试添加必要的断言（关键！） #

你的测试现在执行完performClick就直接结束，很大概率是因为没有后续的断言逻辑——测试框架认为没有需要验证的内容，就直接标记为通过了。你必须在点击后添加对目标屏幕元素的断言，比如：

composeTestRule.onNodeWithContentDescription(composeTestRule.activity.getString(R.string.continue_button))
    .assertIsDisplayed()
    .performClick()
// 添加对屏幕2元素的断言，测试会等待该元素出现
composeTestRule.onNodeWithText("屏幕2的标识文本").assertIsDisplayed()

waitForIdle()只是等待Compose完成绘制，但没有断言的话，测试还是会直接结束。

4. 监听导航事件，确认动作是否触发 #

你可以给测试用的TestNavHostController添加监听，看点击按钮后有没有真正触发导航：

navController.addOnDestinationChangedListener { _, destination, _ ->
    println("当前导航到路由：${destination.route}")
}

运行测试后查看日志，如果没有打印目标路由，说明导航动作根本没被触发，可能是按钮的点击逻辑在测试环境里没执行。

5. 检查路由匹配是否正确 #

确认NEXT_SCREEN常量的路由值，和你在NavHost中注册目标屏幕的路由完全一致——比如大小写、拼写有没有差异，有没有多写/少写字符。如果路由不匹配，导航会静默失败，不会抛出异常。

6. 查看Logcat找线索 #

运行测试时打开Logcat，搜索"NavController"相关的日志，有时候导航失败会输出警告信息（比如"找不到路由xxx"），这些能帮你快速定位问题。

内容的提问来源于stack exchange，提问作者V.Rashkov