SwiftData中能否持久化UIColor？及转换器初始化报错求助

问题根源 #

你遇到的Unable to initialize ValueTransformer for UIColorValueTransformer错误，核心原因有两个：

1. 自定义的UIColorValueTransformer没有提供无参初始化方法，SwiftData需要通过类名实例化Transformer，默认无参init被覆盖后需显式声明。
2. ModelContainer的初始化时机早于ValueTransformer的注册，导致SwiftData找不到已注册的Transformer。

解决方案一：修复自定义ValueTransformer并调整注册时机 #

1. 完善ValueTransformer实现 #

给UIColorValueTransformer添加无参初始化，补充必要类方法，并定义静态名称方便管理：

final class UIColorValueTransformer: ValueTransformer {
    static let name = NSValueTransformerName(rawValue: String(describing: UIColorValueTransformer.self))
    
    // 显式声明无参初始化
    override init() {
        super.init()
    }
    
    override class func transformedValueClass() -> AnyClass {
        return UIColor.self
    }
    
    // 必须返回true以支持反向转换
    override class func allowsReverseTransformation() -> Bool {
        return true
    }
    
    override func transformedValue(_ value: Any?) -> Any? {
        guard let color = value as? UIColor else { return nil }
        do {
            return try NSKeyedArchiver.archivedData(withRootObject: color, requiringSecureCoding: true)
        } catch {
            assertionFailure("UIColor归档失败: \(error)")
            return nil
        }
    }
    
    override func reverseTransformedValue(_ value: Any?) -> Any? {
        guard let data = value as? Data else { return nil }
        do {
            return try NSKeyedUnarchiver.unarchivedObject(ofClass: UIColor.self, from: data)
        } catch {
            assertionFailure("UIColor解归档失败: \(error)")
            return nil
        }
    }
}

2. 调整ModelContainer初始化顺序 #

确保先注册ValueTransformer，再创建ModelContainer，避免时机冲突：

@main
struct TileApp: App {
    let modelContainer: ModelContainer
    
    init() {
        // 先注册Transformer
        ValueTransformer.setValueTransformer(UIColorValueTransformer(), forName: UIColorValueTransformer.name)
        
        // 再初始化ModelContainer
        do {
            modelContainer = try ModelContainer(for: Tile.self)
        } catch {
            fatalError("初始化ModelContainer失败: \(error)")
        }
    }
    
    var body: some Scene {
        WindowGroup {
            ContentView()
                .modelContainer(modelContainer)
        }
    }
}

解决方案二：绕过ValueTransformer，直接存储RGBA值 #

如果觉得归档方式不够稳定（比如部分UIColor子类不支持安全编码），可以直接存储颜色的RGBA分量，通过计算属性对外暴露UIColor：

@Model
final class Tile {
    @Attribute (.unique) var name: String
    var type: String
    // 存储RGBA原始值
    var red: CGFloat
    var green: CGFloat
    var blue: CGFloat
    var alpha: CGFloat
    
    // 对外暴露的UIColor计算属性
    var tileColor: UIColor {
        get { UIColor(red: red, green: green, blue: blue, alpha: alpha) }
        set {
            var r: CGFloat = 0, g: CGFloat = 0, b: CGFloat = 0, a: CGFloat = 0
            newValue.getRed(&r, green: &g, blue: &b, alpha: &a)
            red = r
            green = g
            blue = b
            alpha = a
        }
    }

    init(name: String, type: String, tileColor: UIColor) {
        self.name = name
        self.type = type
        var r: CGFloat = 0, g: CGFloat = 0, b: CGFloat = 0, a: CGFloat = 0
        tileColor.getRed(&r, green: &g, blue: &b, alpha: &a)
        self.red = r
        self.green = g
        self.blue = b
        self.alpha = a
    }
}

这种方式不需要任何Transformer，兼容性更强，也不会出现初始化失败的问题。

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