使用NavigationStack恢复导航状态时绑定失效问题解决

问题根源 #

当应用从后台被杀死重启后，导航路径通过JSONDecoder解码恢复时，Navigation_DetailView中的Item是全新创建的实例，而非原items数组中的引用。由于Item是类类型，虽然数据内容一致，但内存地址不同：

• 编辑这个新实例的name时，原数组中的Item实例不会同步更新，导致列表和详情视图无法感知变化
• 原Item的Equatable/Hashable仅依赖name，会让SwiftUI错误判定新旧实例为同一对象，进一步混淆视图更新逻辑

修复步骤 #

1. 给Item添加唯一标识符 #

用UUID作为Item的唯一身份标识，确保实例唯一性不依赖可变的name：

@Observable class Item : Hashable, Equatable, Codable {
    let id: UUID
    var name: String
    
    init(id: UUID = UUID(), name: String) {
        self.id = id
        self.name = name
    }
    
    static func == (lhs: Item, rhs: Item) -> Bool {
        return lhs.id == rhs.id
    }
    
    public func hash(into hasher: inout Hasher) {
        hasher.combine(id)
    }
}

2. 导航路径存储Item的ID而非实例 #

修改导航标识结构体，仅存储Item的id，避免直接序列化实例：

struct Navigation_DetailView: Hashable, Equatable, Codable {
    let itemId: UUID
}

3. 恢复导航时关联原数组中的实例 #

在ContentView中，通过itemId从原数组查找对应的Item实例，确保视图使用的是原引用：

struct ContentView: View {
    @State var navigation = NavPathStore()
    @State var items: [Item] = [Item(name: "First"), Item(name: "Second")]

    var body: some View {
        NavigationStack(path: $navigation.path) {
            List {
                ForEach(items) { item in
                    NavigationLink(value: Navigation_DetailView(itemId: item.id)) {
                        Text("Item \(item.name)")
                    }
                }
            }
            .navigationDestination(for: Navigation_DetailView.self) { nav in
                if let item = items.first(where: { $0.id == nav.itemId }) {
                    DetailView(item: item)
                } else {
                    Text("Item not found")
                }
            }
        }
    }
}

4. 调整其他依赖逻辑 #

• DetailView和EditView的逻辑无需修改，因为现在接收的是原数组中的Item实例
• 若需要持久化items数组，确保存储的是包含id的完整Item数据，恢复时能重建正确的实例集合

完整修复代码示例 #

@Observable class Item : Hashable, Equatable, Codable {
    let id: UUID
    var name: String
    
    init(id: UUID = UUID(), name: String) {
        self.id = id
        self.name = name
    }
    
    static func == (lhs: Item, rhs: Item) -> Bool {
        return lhs.id == rhs.id
    }
    
    public func hash(into hasher: inout Hasher) {
        hasher.combine(id)
    }
}

@Observable class NavPathStore {
    
    private let savePath = URL.documentsDirectory.appending(path: "SavedPathStore")
    
    public var path = NavigationPath() {
        didSet {
            save()
        }
    }

    init() {
        if let data = try? Data(contentsOf: savePath) {
            if let decoded = try? JSONDecoder().decode(NavigationPath.CodableRepresentation.self, from: data) {
                path = NavigationPath(decoded)
                return
            }
        }
    }

    func save() {
        guard let representation = path.codable else { return }
        do {
            let data = try JSONEncoder().encode(representation)
            try data.write(to: savePath)
        } catch {
            print("Failed to save navigation data")
        }
    }
}


@main
struct TestApp: App {
        
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

struct ContentView: View {
    @State var navigation = NavPathStore()
    @State var items: [Item] = [Item(name: "First"), Item(name: "Second")]

    var body: some View {
        NavigationStack(path: $navigation.path) {
            List {
                ForEach(items) { item in
                    NavigationLink(value: Navigation_DetailView(itemId: item.id)) {
                        Text("Item \(item.name)")
                    }
                }
            }
            .navigationDestination(for: Navigation_DetailView.self) { nav in
                if let item = items.first(where: { $0.id == nav.itemId }) {
                    DetailView(item: item)
                } else {
                    Text("Item not found")
                }
            }
        }
    }
}

struct Navigation_DetailView: Hashable, Equatable, Codable {
    let itemId: UUID
}

struct Navigation_EditView: Hashable, Equatable, Codable {}

struct DetailView: View {

    let item: Item
    
    var body: some View {
        Text("Details for item \(item.name)")
            .toolbar {
                NavigationLink("Edit", value: Navigation_EditView())
            }
            .navigationDestination(for: Navigation_EditView.self) { nav in
                EditView(item: self.item)
            }
    }
}

struct EditView : View {
    @Environment(\.dismiss) private var dismiss
    let item: Item
    @State private var name: String

    init(item: Item) {
        self.item = item
        self.name = item.name
    }
    
    var body: some View {
        VStack {
            TextField("Name", text: $name)
                .textFieldStyle(.roundedBorder)
                .padding()
            
            Button("Save") {
                item.name = self.name
                dismiss()
            }
        }
        .navigationTitle("Item Edition")
    }
}

关键说明 #

• 用UUID作为Item的唯一标识，彻底避免因name变化导致的实例身份混淆
• 导航路径仅存储id，恢复时通过id关联原数组中的实例，保证视图始终操作同一个对象引用
• @Observable的变更通知会正确传递到列表和详情视图，解决重启后绑定失效的问题

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