SwiftData+SwiftUI报错：无法将Optional<Any>转换为UUID

我使用SwiftData实现列表数据删除功能，以下是最小复现代码：

@Model
class ShoppingItem {
    
    var id: UUID
    var quantity: String
    var name: String
    var measuringUnit: String
    var isChecked: Bool
    var createAt: Date
    
    init(id: UUID, quantitly: String, name: String, measuringUnit: String, isChecked: Bool, createAt: Date) {
        self.id = id
        self.quantity = quantitly
        self.name = name
        self.measuringUnit = measuringUnit
        self.isChecked = isChecked
        self.createAt = createAt
    }
}

class ShoppingListView { 
    var shoppingItems = [ShoppingItem]()
}

func fetchData() {
    shoppingItems = []
    do {
        let descriptor = FetchDescriptor<ShoppingItem>(sortBy: [SortDescriptor(\.name)])
        shoppingItems = try modelContext.fetch(descriptor)
    } catch {
        print("Fetch failed")
    }
}

func deleteItem(shoppingItem: ShoppingItem) {
    modelContext.delete(shoppingItem)
}

多数情况下运行正常，但当列表存在2个相似条目时，程序崩溃并抛出以下错误：

Could not cast value of type 'Swift.Optional<Any>' (0x1df9c31f8) to 'Foundation.UUID' (0x1dfa27d58).

报错指向ShoppingItem类中的id属性定义行。

问题原因 #

1. 初始化参数拼写错误：init方法中参数quantitly拼写错误，导致self.quantity未被正确赋值，引发数据存储时的一致性问题，间接导致id字段在底层出现异常类型。
2. 主键未显式声明：虽然手动定义了id作为唯一标识，但未通过@Attribute(.unique)标记告知SwiftData这是主键，底层存储可能对该字段的类型处理出现歧义，当存在相似条目时触发类型转换错误。

解决方法 #

1. 修正初始化方法的拼写错误

将init方法中的参数名quantitly改为quantity，确保属性赋值正确：

init(id: UUID, quantity: String, name: String, measuringUnit: String, isChecked: Bool, createAt: Date) {
    self.id = id
    self.quantity = quantity
    // 其余赋值逻辑不变
}

2. 显式标记主键并优化初始化

为id添加@Attribute(.unique)标记，同时给id和createAt设置默认值，简化初始化并确保主键唯一性：

@Model
class ShoppingItem {
    @Attribute(.unique) var id: UUID
    var quantity: String
    var name: String
    var measuringUnit: String
    var isChecked: Bool
    var createAt: Date
    
    init(id: UUID = UUID(), quantity: String, name: String, measuringUnit: String, isChecked: Bool, createAt: Date = Date()) {
        self.id = id
        self.quantity = quantity
        self.name = name
        self.measuringUnit = measuringUnit
        self.isChecked = isChecked
        self.createAt = createAt
    }
}

3. 确保删除操作的上下文有效性

删除前检查对象是否属于当前modelContext，避免操作游离对象：

func deleteItem(shoppingItem: ShoppingItem) {
    guard modelContext.registeredObjects.contains(shoppingItem) else {
        print("无法删除：当前上下文未管理该对象")
        return
    }
    modelContext.delete(shoppingItem)
    // 可选：立即保存上下文，确保删除操作持久化
    do {
        try modelContext.save()
    } catch {
        print("删除后保存失败：\(error)")
    }
}

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