使用Set定义SwiftData模型导致iOS应用崩溃的原因及解决

问题重现 #

将SwiftUI应用从Core Data迁移到SwiftData时，使用Set存储关联对象导致应用启动崩溃，报错信息如下：

Thread 1: Fatal error: Failed to link relationship to destination entity 'Set because it could not be found in the model: (<NSRelationshipDescription: 0x60000330cc80>), name eggs, isOptional 0, isTransient 0, entity Bird, renamingIdentifier eggs, validation predicates (), warnings (), versionHashModifier (null) userInfo {}, destination entity (null), inverseRelationship (null), minCount 0, maxCount 1, isOrdered 0, deleteRule 2

改用Array存储时应用正常，但Array无法满足元素唯一的需求。相关代码如下：

@Model
class Bird {
    var id: UUID
    var species: String
    @Relationship(deleteRule: .cascade) var eggs = Set<Egg>() // 崩溃
//  @Relationship(deleteRule: .cascade) var eggs = [Egg]()    // 正常
    // 其他属性与方法
}

@Model
class Egg: Codable, Hashable {
    var id: UUID
    var name: String
    var ageWeeks: UInt
    // 其他属性与方法
    static func == (lhs: Egg, rhs: Egg) -> Bool {
        return lhs.id == rhs.id
    }
    func hash(into hasher: inout Hasher) {
        hasher.combine(id)
    }
}

修复方案 #

将Set替换为Array，并为@Relationship添加options: [.unique]配置，既保证关联元素的唯一性，又符合SwiftData的API要求：

@Model
class Bird {
    var id: UUID
    var species: String
    @Relationship(deleteRule: .cascade, options: [.unique]) 
    var eggs = [Egg]() // 实现Set的去重特性且正常运行
    // 其他属性与方法
}

Egg类的代码无需修改，保持原有的Hashable实现即可。

问题原因 #

SwiftData底层基于Core Data实现，但对外暴露的API不支持直接使用Set作为关联属性的存储类型。Core Data的无序关系底层使用NSSet管理，但SwiftData要求开发者使用Array作为关联集合的类型，通过@Relationship的options参数配置集合特性：

• .unique选项：确保关联集合中的元素唯一，等价于Set的去重特性
• .ordered选项：若需要有序集合，可添加该选项

直接使用Set会导致SwiftData无法正确映射到Core Data的实体关系模型，进而触发"找不到目标实体"的致命错误。

官方文档说明 #

SwiftData的@Relationship注解支持通过options参数配置关联集合的行为，其中.unique选项用于约束关联元素的唯一性，对应Core Data中关系的唯一性规则。开发者可通过官方文档了解更多RelationshipOptions的配置细节。

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