SwiftData模型JSON解码后View访问崩溃，重启恢复的问题排查

问题场景 #

我开发了一款从Reddit获取数据的App，在视图的onAppear修饰符中调用数据获取函数：

service.fetch(from: url, completion: { result in
    switch result {
    case .success(let listing):
        save(listing)
    case .failure:
        print("Failed to retrieve and decode data from Reddit")
    }
})

数据保存逻辑：

func save(_ listing: Listing) {
    modelContext.insert(listing)
    do {
        try modelContext.save()
    } catch {
        print("Error saving context")
        print(error.localizedDescription)
    }
}

数据获取与解码逻辑：

func fetch(from url: URL, completion: @escaping (Result<Listing, Error>) -> Void) {
        
    let request = URLService.addUserAgentTo(url)
        
    session.dataTask(with: request, completionHandler: { data, urlResponse, error in
        if let error = error {
            print("Error starting the session")
            print(error.localizedDescription)
            completion(.failure(error))
        } else {
            do {
                let data    = data ?? Data()
                let listing = try self.decoder.decode(Listing.self, from: data)
                completion(.success(listing))
            } catch {
                print("Failed to decode Reddit data")
                print(error.localizedDescription)
                completion(.failure(error))
            }
        }
    }).resume()
}

视图通过List展示帖子标题：

List {
    ForEach(listings) { listing in
        ForEach(listing.data.children.sorted(by: {$0.data.timestamp < $1.data.timestamp})) { post in
            Text(post.data.title)
        }
    }
}

问题现象：首次获取数据时，访问$0.data触发崩溃，报错Thread 1: EXC_BREAKPOINT (code=1, subcode=0x1c3c5ca68)，指向SwiftData的@Model包装器内部代码；但重启App后数据可正常加载，尝试过DispatchQueue.main.async和Task均无效。

可能原因分析 #

1. SwiftData上下文绑定延迟：解码后的Listing及其嵌套关联对象是普通Swift对象，直接插入modelContext后，SwiftData可能未完成关联对象的上下文托管，此时视图立即访问关联属性会触发内部断言崩溃。
2. 主线程操作不彻底：dataTask回调在后台线程，即使save在主线程执行，SwiftData的上下文同步存在延迟，视图在数据未完全被托管时就发起访问。
3. 排序操作触发未托管对象访问：直接在ForEach中对listing.data.children排序，会提前访问未被SwiftData完全托管的嵌套对象，导致状态追踪异常。

具体解决思路 #

1. 确保上下文同步完成后再允许视图访问 #

修改save函数，在保存后强制刷新上下文，确保所有关联对象被正确托管：

func save(_ listing: Listing) {
    DispatchQueue.main.async { [weak self] in
        guard let self = self else { return }
        self.modelContext.insert(listing)
        do {
            try self.modelContext.save()
            // 强制上下文刷新，完成关联对象的托管绑定
            self.modelContext.refreshAllObjects()
        } catch {
            print("Error saving context")
            print(error.localizedDescription)
        }
    }
}

如果使用异步语法重构，效果更稳定：

// 重构fetch为异步函数
func fetch(from url: URL) async -> Result<Listing, Error> {
    return await withCheckedContinuation { continuation in
        let request = URLService.addUserAgentTo(url)
        session.dataTask(with: request) { data, _, error in
            if let error = error {
                print("Error starting the session")
                print(error.localizedDescription)
                continuation.resume(returning: .failure(error))
                return
            }
            do {
                let data = data ?? Data()
                let listing = try self.decoder.decode(Listing.self, from: data)
                continuation.resume(returning: .success(listing))
            } catch {
                print("Failed to decode Reddit data")
                print(error.localizedDescription)
                continuation.resume(returning: .failure(error))
            }
        }.resume()
    }
}

// 重构save为异步函数
func save(_ listing: Listing) async {
    do {
        modelContext.insert(listing)
        try modelContext.save()
        modelContext.refreshAllObjects()
    } catch {
        print("Error saving context")
        print(error.localizedDescription)
    }
}

// 视图onAppear中调用
.onAppear {
    Task {
        let result = await service.fetch(from: url)
        switch result {
        case .success(let listing):
            await save(listing)
        case .failure:
            print("Failed to retrieve and decode data from Reddit")
        }
    }
}

2. 避免在视图中直接操作未托管数组 #

在@Model类中添加排序后的计算属性，确保排序操作在SwiftData对象完全托管后执行：

@Model
class Listing {
    var data: ListingData
    
    // 排序后的计算属性
    var sortedChildren: [Child] {
        data.children.sorted(by: {$0.data.timestamp < $1.data.timestamp})
    }
    
    // 其他属性与初始化方法
}

视图中直接使用该计算属性：

List {
    ForEach(listings) { listing in
        ForEach(listing.sortedChildren) { post in
            Text(post.data.title)
        }
    }
}

3. 检查@Model类的关联关系定义 #

确保嵌套对象的关联关系被@Relationship正确标记，让SwiftData能正确管理所有对象的生命周期：

@Model
class Listing {
    @Relationship(deleteRule: .cascade)
    var data: ListingData
    
    // ...
}

@Model
class ListingData {
    @Relationship(deleteRule: .cascade)
    var children: [Child]
    
    // ...
}

@Model
class Child {
    var data: PostData
    
    // ...
}

4. 添加加载状态延迟视图渲染 #

临时通过加载状态等待上下文同步完成：

@State private var isLoading = true

var body: some View {
    Group {
        if isLoading {
            ProgressView()
        } else {
            List {
                // 原列表代码
            }
        }
    }
    .onAppear {
        service.fetch(from: url) { result in
            switch result {
            case .success(let listing):
                save(listing)
                // 给SwiftData足够同步时间
                DispatchQueue.main.asyncAfter(deadline: .now() + 0.1) {
                    isLoading = false
                }
            case .failure:
                print("Failed to retrieve and decode data from Reddit")
                isLoading = false
            }
        }
    }
}

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