Jetpack Compose报no element matching predicate导航崩溃

崩溃和异常跳转由三个核心问题导致：

• 导航调用违规：你在Compose组合阶段（Surface的代码块内直接写判断调用navigate）触发导航操作。Compose重组会反复执行组合阶段代码，一方面会重复往返回栈插入多个main页面，另一方面导航是异步执行的，触发跳转后OnBoardScreen内的HorizontalPager等组件还会继续执行组合/状态更新，Pager内部匹配不到对应页面状态时就会抛出List contains no element matching the predicate错误。
• 标记写入时机错误：当前逻辑只要进入OnBoardScreen就立刻把firstTime设为false，完全不管用户有没有完成引导流程，直接导致第二次启动时提前触发跳转。
• 起始页配置错误：NavHost的startDestination硬编码为onBoard，非首次启动的用户本不需要进入引导页，却必须先加载OnBoardScreen再触发跳转，就会出现你看到的“引导页闪1秒再跳主屏幕”的现象。

按以下步骤调整代码即可解决问题：

1. 提前判断启动路径，修正NavHost起始页
   不要进入引导页后再做跳转，在NavHost初始化时就读取SharedPreferences标记，直接给非首次启动用户设置main为起始页：

   @OptIn(ExperimentalPagerApi::class)
   @Composable
   fun NavScreen(
       sharedPreferences: SharedPreferences
   ) {
       val navController = rememberNavController()
       // 初始化阶段直接确定正确的启动页
       val startDestination = if (sharedPreferences.getBoolean("firstTime", true)) "onBoard" else "main"
   
       NavHost(navController = navController, startDestination = startDestination) {
           composable("onBoard") {
               OnBoardScreen(navController = navController, sharedPreferences)
           }
           composable("main") {
               MainScreen(navController = navController)
           }
       }
   }
   

2. 删除OnBoardScreen中组合阶段写的firstTime判断和直接跳转逻辑
   所有导航操作禁止直接写在Composable的普通代码块中，只能放在LaunchedEffect等副作用作用域，或者用户点击回调里。
3. 修正首次启动标记的写入时机
   只有用户主动点击Skip/Start按钮完成引导时，才写入firstTime=false标记，同时导航时清空返回栈里的引导页，避免用户按返回键回到引导流程：

   // 在OnBoardScreen里定义统一的引导完成逻辑
   val finishOnBoarding = {
       sharedPreferences.edit()
           .putBoolean("firstTime", false)
           .apply()
       navController.navigate("main") {
           // 清空引导页相关的返回栈
           popUpTo("onBoard") { inclusive = true }
       }
   }
   
   // 替换原来Skip、Start按钮的点击逻辑
   // Skip按钮
   .clickable { finishOnBoarding() }
   
   // Start按钮
   .clickable { finishOnBoarding() }
   

4. 修复Pager页面对齐的协程逻辑
   你当前的LaunchedEffect收集Flow时用了外部collectAsState的缓存值，会导致页面滚动不同步，直接用collect接收到的最新页码即可：

   LaunchedEffect(Unit) {
       onBoardViewModel.currentPage
           .collect { targetPage ->
               pagerState.animateScrollToPage(page = targetPage)
           }
   }
   

调整完成后：首次启动用户会正常看到引导页，操作完成后才进入主页面；非首次启动用户直接进入主页面，不会出现闪屏、崩溃问题。

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