Android Compose导航库NavController.onGraphCreated抛出IllegalStateException

问题分析 #

崩溃堆栈指向NavController.onGraphCreated及NavigatorProvider.get方法，抛出java.lang.IllegalStateException，说明导航组件无法找到对应的Navigator实例。本地测试正常但生产环境部分设备出现，大概率是混淆破坏序列化类、beta版本自动注册Navigator的兼容性问题或导航图初始化前执行导航操作导致。

解决方案 #

1. 添加ProGuard/R8混淆规则 #

生产环境混淆会破坏序列化类和导航组件的类结构，需在proguard-rules.pro中保留相关类：

# 保留序列化类及成员，确保导航目的地能正常序列化/反序列化
-keepnames class * implements kotlinx.serialization.Serializable
-keepclassmembers class * implements kotlinx.serialization.Serializable {
    static <fields>;
}

# 保留导航组件核心Navigator类，避免被混淆移除
-keep class androidx.navigation.compose.AnimatedComposeNavigator
-keep class androidx.navigation.compose.ComposeNavigator

2. 手动注册Navigator #

beta版本可能存在自动注册Navigator的兼容性问题，显式注册确保Navigator存在：

// 在创建NavController的地方添加
val navController = rememberNavController().apply {
    navigatorProvider.addNavigator(AnimatedComposeNavigator())
    navigatorProvider.addNavigator(ComposeNavigator())
}

3. 确保导航图初始化完成后执行导航操作 #

如果有启动时自动导航（如Deep Link处理），用LaunchedEffect依赖navController.graph，确保导航图创建完成：

LaunchedEffect(navController.graph) {
    // 这里执行启动后的导航逻辑，比如处理Deep Link
}

4. 验证目的地序列化实现 #

确保SavedTimeDetail正确实现@Serializable，避免序列化失败导致导航异常：

@Serializable
data class SavedTimeDetail(val stopwatchId: String)

5. 修复DisposableEffect空安全问题（辅助优化） #

虽然这部分不一定直接触发导航崩溃，但可避免额外异常：

DisposableEffect(Unit) {
    window?.addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON)
    onDispose {
        window?.clearFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON)
    }
}

6. 升级到稳定版或更新测试版 #

2.8.0-beta04是测试版本，可能存在已知bug，优先升级到正式版（如已发布）或后续beta版本：

dependencies {
    implementation "androidx.navigation:navigation-compose:2.8.0" // 替换为最新稳定版
}

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