SwiftData如何建模继承关系？解决协议类型不兼容PersistentModel报错

你遇到的Type 'any Activity' cannot conform to 'PersistentModel'错误，本质是SwiftData要求数组属性的元素必须是遵循PersistentModel的类型，而协议类型any Activity无法满足这个要求。下面提供两种可行的解决思路：

方案一：使用类继承（推荐） #

SwiftData原生支持实体继承，将Activity定义为带有公共属性的基类，Run和Swim作为子类继承它，这样就能直接在Workout中使用[Activity]类型的数组。

修改后的完整代码：

import Foundation
import SwiftData

@Model
class Workout {
    var startTime: Date
    var endTime: Date?
    var activities: [Activity]
    
    init(startTime: Date, endTime: Date? = nil, activities: [Activity]) {
        self.startTime = startTime
        self.endTime = endTime
        self.activities = activities
    }
}

@Model
class Activity {
    var calories: Int
    
    init(calories: Int) {
        self.calories = calories
    }
}

@Model
class Run: Activity {
    var steps: Int
    
    init(calories: Int, steps: Int) {
        self.steps = steps
        super.init(calories: calories)
    }
}

@Model
class Swim: Activity {
    var lanes: Int
    
    init(calories: Int, lanes: Int) {
        self.lanes = lanes
        super.init(calories: calories)
    }
}

方案优势 #

• 完全符合SwiftData的设计规范，无需额外处理序列化/反序列化
• 查询时可以直接获取Activity实例，通过类型判断（如if let run = activity as? Run）访问子类专属属性
• SwiftData会自动处理数据库中的继承结构，无需手动管理表关系

方案二：协议+类型擦除（适配必须用协议的场景） #

如果必须基于协议抽象Activity，可以通过类型擦除创建一个遵循PersistentModel的包装类，将协议实例的属性序列化存储。

示例代码：

import Foundation
import SwiftData

@Model
class Workout {
    var startTime: Date
    var endTime: Date?
    var activities: [PersistentActivity]
    
    init(startTime: Date, endTime: Date? = nil, activities: [PersistentActivity]) {
        self.startTime = startTime
        self.endTime = endTime
        self.activities = activities
    }
}

protocol Activity {
    var calories: Int { get }
}

@Model
class PersistentActivity {
    var calories: Int
    var typeIdentifier: String
    var encodedData: Data
    
    init<T: Activity & Codable>(_ activity: T) throws {
        self.calories = activity.calories
        self.typeIdentifier = String(describing: T.self)
        self.encodedData = try JSONEncoder().encode(activity)
    }
    
    func decode<T: Activity & Codable>() throws -> T {
        guard String(describing: T.self) == typeIdentifier else {
            throw NSError(domain: "ActivityError", code: 0, userInfo: [NSLocalizedDescriptionKey: "实体类型不匹配"])
        }
        return try JSONDecoder().decode(T.self, from: encodedData)
    }
}

// 让具体活动类遵循Codable
class Run: Activity, Codable {
    var calories: Int
    var steps: Int
    
    init(calories: Int, steps: Int) {
        self.calories = calories
        self.steps = steps
    }
}

class Swim: Activity, Codable {
    var calories: Int
    var lanes: Int
    
    init(calories: Int, lanes: Int) {
        self.calories = calories
        self.lanes = lanes
    }
}

方案说明 #

• 需要让所有遵循Activity的类同时实现Codable，用于序列化子类专属属性
• 查询后需要调用decode()方法将PersistentActivity转换回具体的Activity实例
• 这种方案相对繁琐，仅在无法使用类继承的场景下考虑

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