SwiftData与SwiftUI预加载关联Challenge的Goal列表崩溃问题

问题背景 #

使用SwiftData和SwiftUI构建关联Challenge模型的Goal模型，需要预加载一批带对应Challenge集合的Goal对象，但在SwiftUI视图中加载预定义列表时应用崩溃。

模型定义 #

Goal模型 #

@Model
class Goal {
    @Attribute(.unique) var id = UUID()
    var title: String
    var completionDate: Date
    var goalDescription: String
    var symbolName: String
    var status: Status
    var inspirationImage: Data?
    var creationDate: Date
    var feedback: [String]

    @Relationship(deleteRule: .cascade, inverse: \Challenge.goal) var challenges: [Challenge]?
    ...
}

Challenge模型 #

@Model
class Challenge {
    var title: String
    var challengeDescription: String

    // 关联关系
    var goal: Goal?
}

预定义列表代码 #

static var examples: [Goal] {
    let challenge1 = Challenge(title: "Daily Meditation", challengeDescription: "Dedicate at least 10 minutes a day to meditation or mindfulness.")
    let challenge2 = Challenge(title: "Digital Detox", challengeDescription: "Reduce screen time, especially before bedtime.")
    let goal = Goal(title: "Improve Mental Health", completionDate: Date.now, goalDescription: "A commitment to nurturing one's mind, reducing stress, and fostering a positive mental environment", symbolName: "brain.head.profile", status: .ongoing, challenges: [challenge1, challenge2])
    let goals = [goal]
    return goals
}

崩溃情况 #

在SwiftUI视图中通过ForEach循环加载该列表时，应用崩溃，断点触发在Goal模型challenges属性的get方法中：

// 错误位置
@Relationship(deleteRule: .cascade, inverse: \Challenge.goal) var challenges: [Challenge]?
{
    @storageRestrictions(accesses: _$backingData, initializes: _challenges)
        init(initialValue) {
                    _$backingData.setValue(forKey: \.challenges, to: initialValue)
                    _challenges = _SwiftDataNoType()
        }

    get {
                    _$observationRegistrar.access(self, keyPath: \.challenges)
                    return self.getValue(forKey: \.challenges) // 崩溃行
        }

    set {
                    _$observationRegistrar.withMutation(of: self, keyPath: \.challenges) {
                            self.setValue(forKey: \.challenges, to: newValue)
                    }
        }
}

错误信息：Thread 1: EXC_BREAKPOINT (code=1, subcode=0x1a8a0803c)

注意：如果实例化Goal时不传入challenges，应用运行正常。

解决方案 #

核心原因 #

直接实例化@Model对象并设置关联关系时，这些对象还未被SwiftData上下文托管，导致关联属性的访问触发内部错误。SwiftData的关联关系依赖于上下文来管理对象间的引用，未托管的对象无法正确处理反向关联（比如Challenge.goal）。

正确实现方式 #

需要将预加载的对象插入到SwiftData上下文后，再建立关联关系，或者通过上下文创建对象来自动处理关联。

方法1：通过上下文创建并关联对象

在视图的onAppear中，检查数据库是否为空，若为空则插入预加载数据：

struct GoalsView: View {
    @Environment(\.modelContext) private var modelContext
    @Query private var goals: [Goal]

    var body: some View {
        List(goals) { goal in
            Text(goal.title)
            ForEach(goal.challenges ?? []) { challenge in
                Text(challenge.title)
            }
        }
        .onAppear {
            preloadSampleData()
        }
    }

    private func preloadSampleData() {
        guard goals.isEmpty else { return }

        // 创建Goal并插入上下文
        let goal = Goal(
            title: "Improve Mental Health",
            completionDate: Date.now,
            goalDescription: "A commitment to nurturing one's mind, reducing stress, and fostering a positive mental environment",
            symbolName: "brain.head.profile",
            status: .ongoing,
            creationDate: Date.now,
            feedback: []
        )
        modelContext.insert(goal)

        // 创建Challenge并关联Goal后插入上下文
        let challenge1 = Challenge(
            title: "Daily Meditation",
            challengeDescription: "Dedicate at least 10 minutes a day to meditation or mindfulness."
        )
        challenge1.goal = goal
        modelContext.insert(challenge1)

        let challenge2 = Challenge(
            title: "Digital Detox",
            challengeDescription: "Reduce screen time, especially before bedtime."
        )
        challenge2.goal = goal
        modelContext.insert(challenge2)

        // 保存上下文
        do {
            try modelContext.save()
        } catch {
            print("预加载数据失败：\(error.localizedDescription)")
        }
    }
}

方法2：调整模型初始化逻辑

修改Goal的初始化方法，去掉直接接收challenges的参数，改为后续通过上下文关联：

@Model
class Goal {
    // ... 现有属性 ...
    @Relationship(deleteRule: .cascade, inverse: \Challenge.goal) var challenges: [Challenge]?

    // 调整初始化方法，移除challenges参数
    init(
        title: String,
        completionDate: Date,
        goalDescription: String,
        symbolName: String,
        status: Status,
        creationDate: Date,
        feedback: [String]
    ) {
        self.title = title
        self.completionDate = completionDate
        self.goalDescription = goalDescription
        self.symbolName = symbolName
        self.status = status
        self.creationDate = creationDate
        self.feedback = feedback
    }
}

之后预加载流程同方法1，先插入Goal到上下文，再创建Challenge并设置goal属性，最后插入上下文。

关键说明 #

• SwiftData的@Relationship属性必须在对象被上下文托管后才能正常工作，未插入上下文的@Model对象无法处理关联的反向引用。
• 静态列表中直接创建关联的@Model对象，会导致对象脱离上下文管理，访问关联属性时触发内部错误。
• 预加载数据时，务必通过modelContext.insert()将对象加入上下文后再建立关联，确保SwiftData能正确管理对象间的引用关系。

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