Jetpack Navigation：如何避免已认证用户启动时先显示AuthScreen？

问题背景 #

我设置了如下导航结构：

NavHost(
    navController = navController,
    startDestination = AuthScreen.route
) {
    composable(
        route = AuthScreen.route
    ) {
        AuthScreen()
    }
    composable(
        route = MainScreen.route
    ) {
        MainScreen()
    }
}

原本根据认证状态同步跳转的逻辑运行正常：

val isUserSignedOut = viewModel.getAuthState().collectAsState().value
if (isUserSignedOut) {
    navController.navigate(AuthScreen.route) {
        popUpTo(navController.graph.id) {
            inclusive = true
        }
    }
} else {
    navController.navigate(MainScreen.route) {
        popUpTo(navController.graph.id) {
            inclusive = true
        }
    }
}

但现在需要在用户已认证时，异步请求判断是否为管理员再跳转对应页面，修改后的代码导致启动应用时，即便用户已认证，也会先显示AuthScreen，直到异步请求完成才跳转目标页面。需要直接跳转到MainScreen或AdminScreen，避免AuthScreen被显示。

补充的认证状态获取代码：
ViewModel层：

fun getAuthState() = authRepo.getAuthState(viewModelScope)

Repo层：

override fun getAuthState(viewModelScope: CoroutineScope) = callbackFlow {
    val listener = FirebaseAuth.AuthStateListener { auth ->
        trySend(auth.currentUser == null)
    }
    auth.addAuthStateListener(listener)
    awaitClose {
        auth.removeAuthStateListener(listener)
    }
}.stateIn(
    scope = viewModelScope,
    started = SharingStarted.WhileSubscribed(),
    initialValue = auth.currentUser == null
)

解决方案 #

核心思路 #

问题根源在于startDestination设置为AuthScreen.route，且异步请求需要时间完成，导致初始页面先加载AuthScreen。解决方向要么是用启动占位页过渡，要么延迟导航初始化直到所有判断完成。

方案一：使用启动占位页（推荐） #

1. 添加启动页路由作为NavHost的初始目标

NavHost(
    navController = navController,
    startDestination = SplashScreen.route
) {
    composable(SplashScreen.route) {
        SplashScreen()
    }
    composable(AuthScreen.route) {
        AuthScreen()
    }
    composable(MainScreen.route) {
        MainScreen()
    }
    composable(AdminScreen.route) {
        AdminScreen()
    }
}

2. 在启动页中完成所有异步判断

@Composable
fun SplashScreen(navController: NavHostController, viewModel: AuthViewModel) {
    val authState = viewModel.getAuthState().collectAsState()
    val adminState = remember { mutableStateOf<Boolean?>(null) }

    LaunchedEffect(authState.value) {
        if (authState.value) {
            // 用户未登录，直接跳转到登录页
            navController.navigate(AuthScreen.route) {
                popUpTo(SplashScreen.route) { inclusive = true }
            }
        } else {
            // 用户已登录，异步请求管理员身份
            val isAdmin = viewModel.checkAdminStatus()
            adminState.value = isAdmin
        }
    }

    LaunchedEffect(adminState.value) {
        adminState.value?.let { isAdmin ->
            val targetRoute = if (isAdmin) AdminScreen.route else MainScreen.route
            navController.navigate(targetRoute) {
                popUpTo(SplashScreen.route) { inclusive = true }
            }
        }
    }

    // 显示加载动画或应用logo
    Box(modifier = Modifier.fillMaxSize(), contentAlignment = Alignment.Center) {
        CircularProgressIndicator()
    }
}

3. 给ViewModel添加管理员判断的挂起函数

class AuthViewModel(private val authRepo: AuthRepo) : ViewModel() {
    fun getAuthState() = authRepo.getAuthState(viewModelScope)

    suspend fun checkAdminStatus(): Boolean {
        // 替换成你的异步请求逻辑，比如调用Firebase或后端API
        return authRepo.checkIfUserIsAdmin()
    }
}

方案二：延迟NavHost初始化 #

如果不想新增启动页，可以在Activity中等待所有判断完成后再构建导航：

class MainActivity : ComponentActivity() {
    private val viewModel: AuthViewModel by viewModels()

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContent {
            val authState = viewModel.getAuthState().collectAsState()
            val adminStatus = remember { mutableStateOf<Boolean?>(null) }

            LaunchedEffect(authState.value) {
                if (!authState.value) {
                    adminStatus.value = viewModel.checkAdminStatus()
                }
            }

            // 认证状态和管理员身份都确定后，才渲染NavHost
            if (authState.value != null && (authState.value || adminStatus.value != null)) {
                val startDest = when {
                    authState.value -> AuthScreen.route
                    adminStatus.value == true -> AdminScreen.route
                    else -> MainScreen.route
                }

                NavHost(
                    navController = rememberNavController(),
                    startDestination = startDest
                ) {
                    // 导航项定义...
                }
            } else {
                // 显示加载中
                Box(modifier = Modifier.fillMaxSize(), contentAlignment = Alignment.Center) {
                    CircularProgressIndicator()
                }
            }
        }
    }
}

额外优化建议 #

• 缓存管理员状态：把管理员身份存在DataStore等本地存储，启动时先读缓存，后台同步最新状态，减少等待时间
• 处理请求失败：添加错误捕获逻辑，比如请求失败时默认跳转到普通用户页面

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