使用带关联值的枚举时SwiftData应用崩溃问题排查

问题复现 #

执行model.setFrequency(.specificDaysOfWeek([.friday, .monday]))时应用崩溃，CoreData报错：

[<Foundation.__NSSwiftData 0x600000c6e8b0>] valueForUndefinedKey: 该类不支持键_buffer的键值编码

完整复现代码 #

1. MyApp初始化ModelContainer

@main
struct MyApp: App {
    let container: ModelContainer
    
    init() {
        do {
            container = try ModelContainer(for: MyModel.self)
        } catch {
            fatalError("Failed to initialize ModelContainer: \(error)")
        }
    }
    
    var body: some Scene {
        WindowGroup {
            ContentView()
                .modelContainer(container)
        }
    }
}

2. 带关联值枚举的@Model类MyModel

enum FrequencyType: Codable {
    case daily
    case weekly
    case specificDaysOfWeek([Weekday])
    
    enum Weekday: String, Codable, CaseIterable {
        case monday, tuesday, wednesday, thursday, friday, saturday, sunday
    }
}

@Model
class MyModel {
    var frequency: FrequencyType
    
    init(frequency: FrequencyType = .daily) {
        self.frequency = frequency
    }
    
    func setFrequency(_ newFrequency: FrequencyType) {
        frequency = newFrequency
    }
}

3. ContentView中的触发操作

struct ContentView: View {
    @Environment(\.modelContext) private var modelContext
    @Query private var models: [MyModel]
    
    var body: some View {
        Button("Add & Update Model") {
            let newModel = MyModel()
            modelContext.insert(newModel)
            // 此行触发崩溃
            newModel.setFrequency(.specificDaysOfWeek([.friday, .monday]))
        }
    }
}

问题根源 #

崩溃本质是SwiftData默认处理带关联值枚举的Codable逻辑，与CoreData的键值编码(KVC)机制冲突。__NSSwiftData是SwiftData存储枚举时的底层包装类型，_buffer是SwiftData内部管理数据的隐藏属性，修改关联值枚举时，KVC错误地尝试访问这个未对外暴露的内部键，导致崩溃。

解决方案 #

方案1：拆解枚举为CoreData原生支持的属性 #

手动将枚举的类型标识和关联值拆分为独立存储属性，绕过默认的Codable自动合成逻辑：

@Model
class MyModel {
    // 存储枚举类型标识
    var frequencyRaw: String
    // 存储关联值（仅specificDaysOfWeek类型有效）
    var specificDays: [String]?
    
    // 对外暴露的计算属性
    var frequency: FrequencyType {
        get {
            switch frequencyRaw {
            case "daily": return .daily
            case "weekly": return .weekly
            case "specificDays":
                guard let days = specificDays, let weekdays = days.compactMap(FrequencyType.Weekday.init(rawValue:)) else {
                    return .daily
                }
                return .specificDaysOfWeek(weekdays)
            default: return .daily
            }
        }
        set {
            switch newValue {
            case .daily:
                frequencyRaw = "daily"
                specificDays = nil
            case .weekly:
                frequencyRaw = "weekly"
                specificDays = nil
            case .specificDaysOfWeek(let days):
                frequencyRaw = "specificDays"
                specificDays = days.map(\.rawValue)
            }
        }
    }
    
    init(frequency: FrequencyType = .daily) {
        self.frequency = frequency
    }
    
    func setFrequency(_ newFrequency: FrequencyType) {
        frequency = newFrequency
    }
}

方案2：使用@Attribute(.transformable)修饰枚举属性 #

明确指定枚举为Transformable类型，同时实现NSSecureCoding协议替代Codable：

// 先修改枚举实现NSSecureCoding
enum FrequencyType: NSSecureCoding {
    static var supportsSecureCoding: Bool { true }
    
    case daily
    case weekly
    case specificDaysOfWeek([Weekday])
    
    enum Weekday: String, NSSecureCoding, CaseIterable {
        static var supportsSecureCoding: Bool { true }
        
        case monday, tuesday, wednesday, thursday, friday, saturday, sunday
        
        func encode(with coder: NSCoder) {
            coder.encode(rawValue, forKey: "rawValue")
        }
        
        required init?(coder: NSCoder) {
            guard let raw = coder.decodeObject(forKey: "rawValue") as? String else { return nil }
            self.init(rawValue: raw)
        }
    }
    
    func encode(with coder: NSCoder) {
        switch self {
        case .daily:
            coder.encode("daily", forKey: "type")
        case .weekly:
            coder.encode("weekly", forKey: "type")
        case .specificDaysOfWeek(let days):
            coder.encode("specificDays", forKey: "type")
            coder.encode(days, forKey: "days")
        }
    }
    
    required init?(coder: NSCoder) {
        guard let type = coder.decodeObject(forKey: "type") as? String else { return nil }
        switch type {
        case "daily":
            self = .daily
        case "weekly":
            self = .weekly
        case "specificDays":
            guard let days = coder.decodeObject(forKey: "days") as? [Weekday] else { return nil }
            self = .specificDaysOfWeek(days)
        default:
            return nil
        }
    }
}

// 修改@Model类的属性修饰
@Model
class MyModel {
    @Attribute(.transformable)
    var frequency: FrequencyType
    
    init(frequency: FrequencyType = .daily) {
        self.frequency = frequency
    }
    
    func setFrequency(_ newFrequency: FrequencyType) {
        frequency = newFrequency
    }
}

验证步骤 #

1. 替换原有MyModel及枚举实现为上述任一方案
2. 重新运行应用，点击"Add & Update Model"按钮
3. 确认崩溃不再发生，枚举值修改正常

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