SwiftData：自定义Identifier类型如何适配@Attribute(.unique)约束

我在测试SwiftData时，定义了一个遵循Identifiable和Codable的Item模型，其id属性是自定义的Identifier<Item>类型（封装UUID），代码如下：

struct Identifier<Value>: Hashable, Codable {
    let value: UUID
    
    init() {
        self.value = UUID()
    }
    
    init(_ uuid: UUID) {
        self.value = uuid
    }
    
    static func fromString(_ string: String) -> Identifier<Value>? {
        guard let uuid = UUID(uuidString: string) else {
            return nil
        }
        return self.init(uuid)
    }
}

但给Item的id添加@Attribute(.unique)时，应用直接崩溃，提示Property type is not valid for unique constraints。即使给Identifier补充了Equatable、CustomDebugStringConvertible等协议，问题依然存在。

核心原因 #

SwiftData的@Attribute(.unique)要求属性类型必须符合PersistentModelAttributeValue协议——这是SwiftData处理底层存储映射的核心协议，UUID默认已经实现，但自定义的Identifier结构体并没有。

可行解决方法 #

方法1：让Identifier实现PersistentModelAttributeValue协议

直接给Identifier添加该协议的实现，让SwiftData能正确识别并映射其底层的UUID：

import SwiftData

struct Identifier<Value>: Hashable, Codable, PersistentModelAttributeValue {
    let value: UUID
    
    init() {
        self.value = UUID()
    }
    
    init(_ uuid: UUID) {
        self.value = uuid
    }
    
    var debugDescription: String {
        value.uuidString.debugDescription
    }
    
    static func fromString(_ string: String) -> Identifier<Value>? {
        guard let uuid = UUID(uuidString: string) else {
            return nil
        }
        return self.init(uuid)
    }
    
    // 实现协议要求的解码方法
    static func decode(from container: any PersistentModelAttributeDecodingContainer) throws -> Self {
        let uuid = try container.decode(UUID.self)
        return self.init(uuid)
    }
    
    // 实现协议要求的编码方法
    func encode(to container: any PersistentModelAttributeEncodingContainer) throws {
        try container.encode(value)
    }
}

完成后，SwiftData就能正确将Identifier的底层UUID作为唯一约束的字段使用。

方法2：拆分属性，用UUID作为唯一约束字段

如果方法1在Beta版中存在兼容性问题，可以调整模型结构：保留自定义Identifier作为对外接口，单独把内部的UUID设为带唯一约束的存储属性：

@Model
class Item: Identifiable, Codable {
    @Attribute(.unique) private let _id: UUID
    // 对外暴露自定义Identifier类型的id
    var id: Identifier<Item> {
        Identifier(_id)
    }
    
    // 其他业务属性...
    
    init() {
        self._id = UUID()
    }
    
    // 手动实现Codable，映射_id和外部的id字段
    enum CodingKeys: String, CodingKey {
        case _id = "id"
        // 其他属性的编码键
    }
    
    required init(from decoder: Decoder) throws {
        let container = try decoder.container(keyedBy: CodingKeys.self)
        self._id = try container.decode(UUID.self, forKey: ._id)
        // 解码其他属性
    }
    
    func encode(to encoder: Encoder) throws {
        var container = encoder.container(keyedBy: CodingKeys.self)
        try container.encode(_id, forKey: ._id)
        // 编码其他属性
    }
}

这种方式绕开了自定义类型的约束限制，直接使用SwiftData原生支持的UUID作为唯一键，同时保留了自定义Identifier的对外使用体验。

是否是Beta版Bug？ #

目前SwiftData仍在迭代优化中，自定义类型的唯一约束支持确实存在一些不完善的地方。如果上述方法都无法解决问题，大概率是Beta版的已知问题，建议关注后续版本更新，也可以向苹果开发者反馈平台提交问题。

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