Android Navigation Composable中Onboarding页按返回键退出应用的实现

问题根源 #

登出后跳转Onboarding时，导航栈中仍保留着Profile、Home等页面，导致按返回键会回到之前的页面；同时原代码拆分两个NavHost分支，逻辑冗余且易引发导航栈异常。

修改方案 #

1. 合并NavHost逻辑，动态指定启动页

将原有的两个NavHost分支合并，通过偏好设置动态计算启动目标，减少代码冗余并统一导航逻辑：

@Composable
fun NavigationComposable() {
    val context = LocalContext.current
    val sp = PreferenceManager.getDefaultSharedPreferences(context)
    val firstName = sp.getString("firstName", null)
    val lastName = sp.getString("lastName", null)
    val email = sp.getString("email", null)

    val navController = rememberNavController()
    // 动态判断启动页面
    val startDestination = if (firstName == null && lastName == null && email == null) {
        Onboarding.route
    } else {
        Home.route
    }

    NavHost(
        navController = navController,
        startDestination = startDestination
    ) {
        composable(Onboarding.route) {
            Onboarding(navController = navController)
        }
        composable(Home.route) {
            Home(navController = navController)
        }
        composable(Profile.route) {
            Profile(navController = navController)
        }
    }
}

2. 登出时清空导航栈

修改Profile页的登出逻辑，使用popUpTo清空整个导航栈，确保Onboarding成为栈底页面：

@Composable
fun Profile(navController: NavController) {
    val context = LocalContext.current
    Column(
        modifier = Modifier.fillMaxWidth().padding(10.dp),
        horizontalAlignment = Alignment.CenterHorizontally
    ) {
        Button(onClick = {
            // 清除偏好设置
            PreferenceManager.getDefaultSharedPreferences(context).edit().clear().apply()
            // 清空导航栈并跳转Onboarding
            navController.navigate(Onboarding.route) {
                // 弹出栈中所有页面，包括启动页
                popUpTo(navController.graph.startDestinationId) {
                    inclusive = true
                }
                // 避免重复入栈
                launchSingleTop = true
            }
        }) {
            Text(text = "Log out")
        }
    }
}

3. 增强Onboarding页返回键处理

给Onboarding页添加返回键拦截，确保页面处于栈底时直接退出应用：

@Composable
fun Onboarding(navController: NavController) {
    val context = LocalContext.current
    // 处理返回键：退出当前Activity
    BackHandler {
        (context as Activity).finish()
    }

    // 你的Onboarding页面原有内容...
}

原理说明 #

• 合并NavHost后，导航逻辑统一，避免重复注册路由导致的栈异常；
• popUpTo配合inclusive = true会清空导航栈中所有历史页面，让Onboarding成为唯一页面，此时按返回键会触发系统默认的退出行为；
• BackHandler进一步明确处理返回逻辑，覆盖边缘场景下的栈异常情况。

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