SwiftData模型继承Codable类的实现问题及替代方案

问题背景 #

后端用Swift编写，部署在GCP Cloud Run（Linux环境，无法访问Apple专属框架），定义了跨端共享的Codable类：

open class MyClass: Codable, Identifiable {
    var id: String
    var name: String

    init(id: String, name: String) {
        self.id = id
        self.name = name
    }
}

该类通过Swift包在前后端共享，实现后端编码、前端解码的数据传输。现在前端需要用SwiftData管理该类的数据，但配置过程中遇到初始化冲突问题。

尝试过程 #

1. 最初创建带@Model宏的子类：

@Model
class MyFrontendClass: MyClass { }

报错：@Model requires an initializer be provided for 'MyFrontendClass'

2. 添加调用父类初始化器的基本初始化器：

@Model
class MyFrontendClass: MyClass {
    override init(id: String, name: String) {
        super.init(id: id, name: name)
    }
}

报错：'required' initializer 'init(from:)' must be provided by subclass of 'MyClass'

3. 添加init(from:)初始化器：

@Model
class MyFrontendClass: MyClass {
    override init(id: String, name: String) {
        super.init(id: id, name: name)
    }
    required init(from decoder: Decoder) throws {
        try super.init(from: decoder)
    }
}

此时@Model宏生成的代码出现两个错误：

1. 'self' used in property access 'persistentBackingData' before 'super.init' call
2. 'super.init' isn't called on all paths before returning from initializer

错误来自宏生成的初始化器：

required init(backingData: any SwiftData.BackingData<MyFrontendClass>) {
  self.persistentBackingData = backingData
}

解决方案 #

方案一：用协议替代类继承（推荐） #

将跨端共享的MyClass改为协议，前后端各自实现，避免SwiftData与类继承的冲突：

// 共享包中的协议（无Apple框架依赖）
public protocol MyDataProtocol: Codable, Identifiable {
    var id: String { get set }
    var name: String { get set }
    init(id: String, name: String)
}

// 后端实现
public class MyBackendClass: MyDataProtocol {
    public var id: String
    public var name: String
    
    public init(id: String, name: String) {
        self.id = id
        self.name = name
    }
}

// 前端SwiftData模型
@Model
public class MyFrontendClass: MyDataProtocol {
    public var id: String
    public var name: String
    
    public init(id: String, name: String) {
        self.id = id
        self.name = name
    }
}

这种方式下，前端的SwiftData模型可以正常使用@Model宏，同时遵循共享协议保证与后端的Codable兼容性，完全规避继承带来的初始化问题。

方案二：组合模式（保留原有共享类） #

如果不想修改共享类的结构，可以将MyClass作为SwiftData模型的属性，通过计算属性直接访问字段：

// 共享的MyClass保持不变
open class MyClass: Codable, Identifiable {
    var id: String
    var name: String

    init(id: String, name: String) {
        self.id = id
        self.name = name
    }
}

// 前端SwiftData模型
@Model
class MyFrontendModel {
    var data: MyClass
    
    // 计算属性，简化字段访问
    var id: String { data.id }
    var name: String { data.name }
    
    init(data: MyClass) {
        self.data = data
    }
    
    // 提供便捷初始化方法
    init(id: String, name: String) {
        self.data = MyClass(id: id, name: name)
    }
}

此方案避免了继承，SwiftData可以正常管理MyFrontendModel，同时data属性本身是Codable类型，保证与后端的数据传输兼容。

方案三：继承场景的修复（不推荐） #

由于SwiftData的@Model宏生成的backingData初始化器要求先设置persistentBackingData，但父类MyClass没有无参初始化器，无法在调用super.init()前完成self的初始化，两者逻辑冲突，因此该路径本质上不可行，不推荐尝试。

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