升级Xcode 16后SwiftData报CoreData Array类实例化错误求解决

问题现象 #

升级Xcode 16后，编译运行时频繁出现三类日志（对应白色通知、黄色警告、红色错误）：

CoreData: fault: Could not materialize Objective-C class named "Array" from declared attribute value type "Array<String>" of attribute named categories

fault: Could not materialize Objective-C class named "Array" from declared attribute value type "Array<String>" of attribute named categories

CoreData: Could not materialize Objective-C class named "Array" from declared attribute value type "Array<String>" of attribute named categories

问题涉及Array<String>和Array<UUID>类型，每个相关属性都会触发这三条日志。

同时，应用在iOS 18上运行极慢且频繁崩溃，但在iOS 17上完全正常。我有多个包含数组类型的SwiftData模型，仅部分模型触发该问题。

涉事模型代码 #

@Model
class CategoryGroupDetailsSD {
    @Attribute(.unique) var id: String
    var name: String
    var categories: [String]
    var icon: String?
    var updatedAt: Date?

    init(id: String, name: String, categories: [String], icon: String?, updatedAt: Date?) {
        self.id = id
        self.name = name
        self.categories = categories
        self.icon = icon
        self.updatedAt = updatedAt
    }

    convenience init(item: CategoryGroupDetailsDTO) {
        self.init(
            id: item.id,
            name: item.name,
            categories: item.categories,
            icon: item.icon,
            updatedAt: item.updatedAt
        )
    }
}

extension CategoryGroupDetailsSD {
    func updateProperties(from other: CategoryGroupDetailsDTO) {
        self.name = other.name
        self.categories = other.categories
        self.icon = other.icon
        self.updatedAt = other.updatedAt
    }
}

诊断与解决方法 #

1. 显式标注数组属性的存储类型 #

SwiftData在Xcode 16中对数组属性的隐式映射可能存在异常，尝试给数组属性添加@Attribute注解明确类型，同时设置默认空值避免未初始化问题：

@Attribute(.array(of: String.self)) 
var categories: [String] = []

或使用可转换类型标注：

@Attribute(.transformable(by: [String].self)) 
var categories: [String] = []

2. 清理项目缓存与旧数据 #

• 清理Xcode DerivedData：打开Xcode > Settings > Locations > DerivedData，点击路径删除对应文件夹
• 删除模拟器/真机上的应用，彻底清除旧的CoreData存储文件
• 执行Product > Clean Build Folder（快捷键Cmd+Shift+K）

3. 检查模型版本与数据迁移 #

如果是从iOS 17的SwiftData模型升级到iOS 18，可能存在版本兼容问题：

• 确认所有SwiftData模型属性类型在iOS 18下的兼容性
• 删除项目中的.swiftdata文件夹后重新构建，强制生成新的模型Schema

4. 排查属性命名冲突 #

临时修改涉事属性名（比如把categories改成categoryList），测试是否仍触发报错，排查是否存在与框架内部关键字冲突的情况。

5. 验证Xcode版本修复 #

若上述方法无效，尝试切换到Xcode 16的最新正式版/测试版，该问题可能是Xcode的已知bug，后续版本会修复。

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