Jetpack Compose类型安全导航：多页回退带参初始页报错解决

问题场景 #

我有一个接收参数的首页（MainScreen），从该页面跳转到多个其他页面后，希望返回原首页。因为首页需要参数，回退时得传递参数。我用Jetpack Compose的类型安全导航，定义的导航路由如下：

@Serializable
sealed class MyGraph {

    @Serializable
    data class MainScreen(val isNew: Boolean) : MyGraph()
}

尝试用以下代码回退到首页：

navController.navigate(MyGraph.MainScreen){
    popUpTo<MyGraph.MainScreen>(){ inclusive = false }
    launchSingleTop = true
}

结果抛出错误：

kotlinx.serialization.SerializationException: Serializer for class 'Companion' is not found.
Please ensure that class is marked as '@Serializable' and that the serialization compiler plugin is applied.

预期是直接返回栈中已存在的带参首页。

问题原因与修复方案 #

这个错误是因为调用MyGraph.MainScreen时没有传入构造参数，误引用了MainScreen的伴生对象（Kotlin会为数据类自动生成未标记序列化的伴生对象），导致序列化库无法处理。以下是两种正确的解决方式：

方式1：传入原参数回到已有页面

如果你知道首页原来的isNew参数值，直接传入该值，配合popUpTo和launchSingleTop就能回到栈中的首页，不会重新创建实例：

// 替换originalIsNew为首页实际的参数值
navController.navigate(MyGraph.MainScreen(originalIsNew)) {
    popUpTo<MyGraph.MainScreen> { inclusive = false }
    launchSingleTop = true
}

方式2：直接回退到栈中已有页面（无需传参）

如果只是想回到栈中已存在的首页，不需要重新构建路由对象，直接用popBackStack操作即可：

// 直接回退到最近的MainScreen实例
navController.popBackStack<MyGraph.MainScreen>(inclusive = false)

关键说明 #

• 调用MyGraph.MainScreen而不传参数时，实际是在引用它的伴生对象，这个自动生成的伴生对象没有被标记@Serializable，所以触发序列化错误。必须传入构造参数创建MainScreen的实例。
• popUpTo<MyGraph.MainScreen>(inclusive = false)会确保回退到栈中最近的MainScreen实例且不删除它；launchSingleTop = true会避免创建新的页面实例。

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