SwiftUI DocumentGroup导航异常：返回至文档选择器而非主列表

问题背景 #

基于Xcode模板开发的SwiftData多平台文档App，在iPhone端存在导航逻辑异常：创建Item并进入详情页后，点击返回按钮会直接跳转至文档选择器，而非预期的主列表页面。尝试使用.navigationBarBackButtonHidden(true)无法禁用DocumentGroup自带的返回按钮，导致自定义导航的返回功能失效。iPad和Mac端因采用NavigationSplitView不存在此问题，且双导航栏问题可通过添加DocumentGroupLaunchScene修复。

解决方案 #

1. 修复双导航栏问题 #

首先通过添加DocumentGroupLaunchScene解决双导航栏问题，修改App入口代码如下：

@main
struct SwiftDataDocumentSketchApp: App {
    var body: some Scene {
        #if os(iOS)
        DocumentGroupLaunchScene("Sketch") {
            NewDocumentButton("Create new doc")
        } background: {
            Color.yellow
        } overlayAccessoryView: { _ in
            Text("Your accessory here")
        }
        #endif
        
        DocumentGroup(editing: .itemDocument, migrationPlan: SwiftDataDocumentSketchMigrationPlan.self) {
            ContentView()
        }
    }
}

2. 禁用DocumentGroup自带返回按钮，修复导航逻辑 #

由于iPhone端的DocumentGroup会在外层包裹一个默认的UINavigationController，直接在ContentView的导航栈中设置.navigationBarBackButtonHidden(true)无法影响外层导航栏。我们需要在ContentView中通过代码获取外层导航控制器，修改其返回按钮行为：

struct ContentView: View {
    @Environment(\.modelContext) private var modelContext
    @Query private var items: [Item]

    var body: some View {
        NavigationStack {
            List {
                Button("Add Item") {
                    addItem()
                }
                ForEach(items) { item in
                    NavigationLink(destination: DetailView(item: item)) {
                        Text(item.timestamp, format: Date.FormatStyle(date: .numeric, time: .standard))
                    }
                }
                .onDelete(perform: deleteItems)
            }
            .navigationTitle("My Items")
            // 隐藏内层导航栈的返回按钮
            .navigationBarBackButtonHidden(true)
        }
        .onAppear {
            #if os(iOS)
            // 获取外层的UINavigationController
            if let navController = UIApplication.shared.connectedScenes
                .compactMap({ $0 as? UIWindowScene })
                .first?.windows
                .first?.rootViewController as? UINavigationController {
                // 将外层导航栏的返回按钮设置为空，禁用默认返回行为
                navController.navigationBar.topItem?.backBarButtonItem = UIBarButtonItem(title: "", style: .plain, target: nil, action: nil)
                // 若不需要外层导航栏，可直接隐藏：
                // navController.setNavigationBarHidden(true, animated: false)
            }
            #endif
        }
    }

    private func addItem() {
        withAnimation {
            let newItem = Item(timestamp: Date())
            modelContext.insert(newItem)
        }
    }

    private func deleteItems(offsets: IndexSet) {
        withAnimation {
            offsets.map { items[$0] }.forEach(modelContext.delete)
        }
    }
}

struct DetailView: View {
    let item: Item

    var body: some View {
        Text("Item at \(item.timestamp, format: Date.FormatStyle(date: .numeric, time: .standard))")
            .navigationTitle("Item Detail")
    }
}

原理说明 #

• DocumentGroupLaunchScene会替换iPhone端默认的文档选择器启动流程，避免出现双导航栏。
• 通过代码获取外层UINavigationController并修改其返回按钮，直接禁用DocumentGroup自带的返回行为，确保内层自定义NavigationStack的返回按钮（回到主列表）成为唯一的返回入口。

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