SwiftData是否支持类似Core Data的ValueTransformer实现属性加解密？

在 Core Data 中，我们可以通过 ValueTransformer 对单个属性在与存储层交互时自动执行转换（比如你提供的示例就实现了 UIColor 和 Data 的双向转换：存储时将颜色归档为二进制数据，读取时再解档回颜色对象），这类逻辑在加密解密场景中非常实用。而在 SwiftData 中并没有直接对应的原生 API，但可以通过以下几种方式实现类似需求——存储时保存加密数据，通过 @Query 获取时自动拿到解密后的数据：

方法一：使用计算属性（简单直接） #

在 SwiftData 模型中定义一个用于存储加密数据的持久化属性，再通过计算属性封装加密解密逻辑，对外暴露解密后的数据：

import SwiftData
import CryptoKit

@Model
final class User {
    // 持久化存储的加密后数据
    @Attribute(.unique) private var encryptedEmail: Data
    
    // 对外暴露的解密后邮箱属性
    var email: String {
        get {
            // 替换为你的解密逻辑，示例采用AES-GCM算法
            guard let sealedBox = try? AES.GCM.SealedBox(combined: encryptedEmail),
                  let decryptedData = try? AES.GCM.open(sealedBox, using: /* 你的密钥 */) else {
                return ""
            }
            return String(data: decryptedData, encoding: .utf8) ?? ""
        }
        set {
            // 替换为你的加密逻辑
            guard let data = newValue.data(using: .utf8) else { return }
            let sealedBox = try! AES.GCM.seal(data, using: /* 你的密钥 */)
            encryptedEmail = sealedBox.combined!
        }
    }
    
    init(email: String) {
        self.email = email
    }
}

注意：计算属性无法被 @Query 用于筛选、排序等查询操作，因为 SwiftData 仅能对持久化存储的属性执行查询。如果不需要基于解密后的数据做查询，这种方式是最简便的。

方法二：自定义属性包装器（灵活可复用） #

通过自定义属性包装器封装加密解密逻辑，让模型定义更简洁，同时保持逻辑的复用性：

import SwiftData
import CryptoKit

@propertyWrapper
struct Encrypted {
    private var storedData: Data
    private let key: SymmetricKey // 实际项目中密钥应安全存储至Keychain
    
    init(wrappedValue: String, key: SymmetricKey) {
        self.key = key
        // 初始化时直接加密原始值
        guard let data = wrappedValue.data(using: .utf8) else {
            self.storedData = Data()
            return
        }
        let sealedBox = try! AES.GCM.seal(data, using: key)
        self.storedData = sealedBox.combined!
    }
    
    var wrappedValue: String {
        get {
            // 解密逻辑
            guard let sealedBox = try? AES.GCM.SealedBox(combined: storedData),
                  let decryptedData = try? AES.GCM.open(sealedBox, using: key) else {
                return ""
            }
            return String(data: decryptedData, encoding: .utf8) ?? ""
        }
        set {
            // 加密逻辑
            guard let data = newValue.data(using: .utf8) else { return }
            let sealedBox = try! AES.GCM.seal(data, using: key)
            storedData = sealedBox.combined!
        }
    }
    
    // 适配SwiftData持久化，将包装器关联到存储属性
    static func _propertyBridgeGet(_ storage: Data, arguments: SymmetricKey) -> String {
        guard let sealedBox = try? AES.GCM.SealedBox(combined: storage),
              let decryptedData = try? AES.GCM.open(sealedBox, using: arguments) else {
            return ""
        }
        return String(data: decryptedData, encoding: .utf8) ?? ""
    }
    
    static func _propertyBridgeSet(_ storage: inout Data, arguments: SymmetricKey, value: String) {
        guard let data = value.data(using: .utf8) else { return }
        let sealedBox = try! AES.GCM.seal(data, using: arguments)
        storage = sealedBox.combined!
    }
}

// 模型中使用示例
@Model
final class User {
    @Attribute private var encryptedEmail: Data
    @Encrypted(key: /* 你的密钥 */) var email: String {
        didSet {
            // 同步加密后数据到持久化属性
            guard let data = email.data(using: .utf8) else { return }
            let sealedBox = try! AES.GCM.seal(data, using: /* 你的密钥 */)
            encryptedEmail = sealedBox.combined!
        }
    }
    
    init(email: String) {
        self.email = email
        // 初始化持久化属性
        guard let data = email.data(using: .utf8) else {
            self.encryptedEmail = Data()
            return
        }
        let sealedBox = try! AES.GCM.seal(data, using: /* 你的密钥 */)
        self.encryptedEmail = sealedBox.combined!
    }
}

方法三：读写时手动处理（支持查询场景） #

如果需要基于解密后的数据执行查询，可以在写入前手动加密，读取后手动解密：

import SwiftData
import CryptoKit

@Model
final class User {
    @Attribute(.unique) var encryptedEmail: Data
    
    init(encryptedEmail: Data) {
        self.encryptedEmail = encryptedEmail
    }
    
    // 解密方法
    func decryptEmail(with key: SymmetricKey) -> String? {
        guard let sealedBox = try? AES.GCM.SealedBox(combined: encryptedEmail),
              let decryptedData = try? AES.GCM.open(sealedBox, using: key) else {
            return nil
        }
        return String(data: decryptedData, encoding: .utf8)
    }
}

// 写入示例
let rawEmail = "user@example.com"
guard let data = rawEmail.data(using: .utf8) else { return }
let sealedBox = try! AES.GCM.seal(data, using: /* 你的密钥 */)
let user = User(encryptedEmail: sealedBox.combined!)
context.insert(user)

// 读取示例
@Query var users: [User]
let key: SymmetricKey = /* 从Keychain获取密钥 */
let decryptedEmails = users.compactMap { $0.decryptEmail(with: key) }

与 Core Data ValueTransformer 的差异 #

Core Data 的 ValueTransformer 是在底层存储层自动完成转换，对上层业务代码完全透明；而 SwiftData 的上述方案需要在模型层显式处理转换逻辑，但同样能实现「存储加密数据、读取明文数据」的核心需求。

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