Android Compose中如何在配置变更时保存导航状态？

当使用单Activity+Compose+NavController架构时，配置变更（如屏幕旋转）导致导航重置到startDestination，核心原因是导航控制器的状态没有被正确保留。以下是两种可靠的解决方法：

方法一：使用rememberNavController()初始化（推荐基础场景） #

rememberNavController()是Compose导航库提供的专用API，内部已经实现了配置变更时的状态保存逻辑，只要正确使用就能自动保留导航栈。

示例代码：

@Composable
fun RootNavHost() {
    // 用rememberNavController()创建导航控制器，状态会自动在配置变更后恢复
    val navController = rememberNavController()

    NavHost(
        navController = navController,
        startDestination = "home_screen"
    ) {
        composable("home_screen") { HomeScreen(navController) }
        composable("detail_screen/{itemId}") { backStackEntry ->
            val itemId = backStackEntry.arguments?.getString("itemId") ?: ""
            DetailScreen(itemId, navController)
        }
        // 其他导航目的地定义...
    }
}

注意：必须在NavHost所在的Composable或其父Composable中调用rememberNavController()，避免在局部Composable中重复创建导致实例丢失。

方法二：用ViewModel持有NavController（适合全局导航场景） #

如果你的导航需要在Activity、多个Composable之间共享，或者需要更稳定的生命周期管理，可以将NavController放在ViewModel中——ViewModel在配置变更时不会被销毁，能完整保留导航状态。

步骤1：创建持有NavController的ViewModel #

class MainNavViewModel : ViewModel() {
    lateinit var navController: NavHostController

    fun initNavController(context: Context) {
        // 仅初始化一次，避免重复创建
        if (!::navController.isInitialized) {
            navController = NavHostController(context)
        }
    }
}

步骤2：在Activity中关联ViewModel并使用 #

class MainActivity : ComponentActivity() {
    private val navViewModel by viewModels<MainNavViewModel>()

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContent {
            MyAppTheme {
                // 初始化导航控制器
                navViewModel.initNavController(this)

                NavHost(
                    navController = navViewModel.navController,
                    startDestination = "home_screen"
                ) {
                    // 定义导航目的地...
                }
            }
        }
    }
}

常见错误排查 #

• 不要在onCreate或每次重组时手动创建新的NavHostController实例，否则配置变更会丢失状态。
• 确保NavHost始终使用同一个NavController实例，不要在重组时重新赋值。
• 检查是否自定义了导航逻辑，比如手动清空返回栈，这会导致状态无法保留。

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