iOS Core Data存储含对象数组的实体属性报错求解

你遇到的问题根源是：Core Data的Transformable属性默认依赖NSCoding协议进行序列化，但你的Exercise是Swift struct，仅遵循Decodable/Identifiable，直接转NSObject无法满足NSKeyedUnarchiver的编码要求，导致抛出异常。下面提供两种可靠的解决方案：

方案一：自定义ValueTransformer（利用Codable序列化） #

既然你的struct已经遵循Decodable，只需补上Encodable（直接改为遵循Codable），再通过自定义转换器实现JSON编码和解码，替代默认的归档逻辑。

步骤1：让Struct遵循Codable #

struct Exercise: Identifiable, Codable {
    let id: UUID
    // 你的其他属性，比如name、duration等
}

struct ExerciseGroup: Identifiable, Codable {
    let id: UUID
    let exercises: [Exercise]
    // 你的其他属性
}

步骤2：实现自定义ValueTransformer #

创建一个继承自ValueTransformer的类，专门处理[Exercise]的编码和解码：

class ExercisesTransformer: ValueTransformer {
    // 指定转换后的数据类型为Data
    override class func transformedValueClass() -> AnyClass {
        Data.self
    }

    // 支持反向转换（从Data转回[Exercise]）
    override class func allowsReverseTransformation() -> Bool {
        true
    }

    // 将[Exercise]编码为Data
    override func transformedValue(_ value: Any?) -> Any? {
        guard let exercises = value as? [Exercise] else { return nil }
        return try? JSONEncoder().encode(exercises)
    }

    // 将Data解码回[Exercise]
    override func reverseTransformedValue(_ value: Any?) -> Any? {
        guard let data = value as? Data else { return nil }
        return try? JSONDecoder().decode([Exercise].self, from: data)
    }

    // 注册转换器（在App启动时调用）
    static func register() {
        let transformer = ExercisesTransformer()
        ValueTransformer.setValueTransformer(
            transformer,
            forName: NSValueTransformerName(rawValue: "ExercisesTransformer")
        )
    }
}

步骤3：配置Core Data模型 #

1. 打开ExerciseStorageModel.xcdatamodel，选中ExerciseGroupStorage的exercises属性
2. 类型选择Transformable
3. 在右侧检查器中：
   • Custom Class填写[Exercise]
   • Value Transformer填写ExercisesTransformer
   • 勾选Allow External Storage（大数组时优化存储）

步骤4：注册转换器&赋值 #

在App启动时注册转换器（比如AppDelegate的didFinishLaunchingWithOptions或SceneDelegate的willConnectTo）：

ExercisesTransformer.register()

赋值时直接使用原始数组，无需转NSObject：

let groupStorage = ExerciseGroupStorage(context: managedObjectContext)
groupStorage.exercises = eg.exercises
// 保存上下文
do {
    try managedObjectContext.save()
} catch {
    print("保存失败：\(error)")
}

方案二：将Exercise转为Core Data实体（推荐复杂场景） #

如果需要对单个Exercise进行查询、修改等操作，更符合Core Data ORM设计的方式是：把Exercise也做成实体，和ExerciseGroupStorage建立一对多关系。

步骤1：添加ExerciseStorage实体 #

在ExerciseStorageModel.xcdatamodel中新增ExerciseStorage实体，添加与Exercise struct对应的属性（比如id、name等）。

步骤2：建立实体关系 #

1. 在ExerciseGroupStorage中添加to-many关系，命名为exercises，目标实体选择ExerciseStorage
2. 在ExerciseStorage中添加to-one关系，命名为exerciseGroup，目标实体选择ExerciseGroupStorage，并设置为exercises关系的Inverse（反向关系）

步骤3：Struct转实体的工具方法 #

func convertToStorage(exercise: Exercise, context: NSManagedObjectContext) -> ExerciseStorage {
    let storage = ExerciseStorage(context: context)
    storage.id = exercise.id
    storage.name = exercise.name // 示例属性，替换为你的实际属性
    return storage
}

func convertToStorage(group: ExerciseGroup, context: NSManagedObjectContext) -> ExerciseGroupStorage {
    let groupStorage = ExerciseGroupStorage(context: context)
    groupStorage.id = group.id
    let exerciseStorages = group.exercises.map { convertToStorage(exercise: $0, context: context) }
    groupStorage.addToExercises(NSSet(array: exerciseStorages)) // 方法名由Core Data自动生成，可能略有不同
    return groupStorage
}

步骤4：保存数据 #

let groupStorage = convertToStorage(group: eg, context: managedObjectContext)
do {
    try managedObjectContext.save()
} catch {
    print("保存失败：\(error)")
}

方案对比 #

• 自定义Transformer：适合简单场景，无需修改实体结构，代码量少；但无法单独查询或修改数组中的单个Exercise，数据量大时性能不如实体关系。
• 实体关系：符合Core Data的设计理念，支持复杂查询、修改，数据一致性更好；适合需要频繁操作单个Exercise的场景。

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