Navigation 3中NavDisplay如何支持同Key的多个返回栈条目？

先看官方文档的示例代码：

data object Home
data class Product(val id: String)

@Composable
fun NavExample() {

    val backStack = remember { mutableStateListOf<Any>(Home) }

    NavDisplay(
        backStack = backStack,
        onBack = { backStack.removeLastOrNull() },
        entryProvider = { key ->
            when (key) {
                is Home -> NavEntry(key) {
                    ContentGreen("Welcome to Nav3") {
                        Button(onClick = {
                            backStack.add(Product("123"))
                        }) {
                            Text("Click to navigate")
                        }
                    }
                }

                is Product -> NavEntry(key) {
                    ContentBlue("Product ${key.id} ")
                }

                else -> NavEntry(Unit) { Text("Unknown route") }
            }
        }
    )
}

当返回栈包含Home和Product(id = "123")时，显示ContentBlue，弹出栈后回到ContentGreen。但如果栈中存在两个Product(id = "123")条目，由于二者Key完全相同，NavDisplay会复用同一个NavEntry，导致这两个栈条目共享Composition和SavedStateHolder。

这种问题在多页面跳转场景下更突出：比如在分类页和商品页间反复导航，栈中可能出现多个相同商品ID的条目，但我们需要这些条目作为独立个体存在（比如不希望恢复之前的滚动状态）。

虽然可以通过在Key中加入栈索引等方式解决，但想确认Navigation 3是否有官方标准/框架方案来支持同Key的多个返回栈条目？该场景并不特殊，但文档中未提及相关内容。

官方规范方案说明 #

Navigation 3的设计逻辑中，返回栈条目的Key必须具备唯一性——NavDisplay依赖Key来区分不同的导航实例，进而管理各自的SavedState和Composition。官方并没有提供直接支持"同Key多条目"的内置功能，但有明确的标准实践来解决这类场景：

• 为每个导航条目生成唯一Key：不要仅用页面数据（如Product的id）作为Key，而是创建包含唯一标识的导航Key类，比如添加自动生成的UUID或自增序列：

data object Home
// 新增包含唯一标识的导航Key
data class ProductNavKey(val productId: String, val navId: UUID = UUID.randomUUID())

@Composable
fun NavExample() {
    val backStack = remember { mutableStateListOf<Any>(Home) }

    NavDisplay(
        backStack = backStack,
        onBack = { backStack.removeLastOrNull() },
        entryProvider = { key ->
            when (key) {
                is Home -> NavEntry(key) {
                    ContentGreen("Welcome to Nav3") {
                        Button(onClick = {
                            // 导航时生成新的唯一Key实例
                            backStack.add(ProductNavKey("123"))
                        }) {
                            Text("Click to navigate")
                        }
                    }
                }

                is ProductNavKey -> NavEntry(key) {
                    ContentBlue("Product ${key.productId} ")
                }

                else -> NavEntry(Unit) { Text("Unknown route") }
            }
        }
    )
}

通过这种方式，每个导航条目都有唯一的Key，NavDisplay会为每个条目创建独立的NavEntry，状态完全隔离，不会出现复用问题。

• 官方设计逻辑：相同Key在导航栈中被视为同一个目的地的同一实例，复用状态是预期行为。如果需要独立实例，本质上属于不同的导航条目，必须用唯一Key区分，这是官方推荐的标准处理方式。

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