Swift使用Combine编写泛型类出现Key path类型不匹配错误如何解决

错误原因 #

Key path value type '[T]' cannot be converted to contextual type 'T'

这个报错由三个代码问题共同导致：

1. 初始化方法重复声明了泛型参数<T: Codable>，和类层面定义的泛型T完全独立、类型不匹配
2. 解码类型与接收结果的属性类型不匹配：你当前调用decode传入的是T.self，解码后输出单个T实例，但要赋值的result属性是[T]数组类型
3. replaceError逻辑存在运行时崩溃风险，T.self as! T是将T的元类型强制转换为T实例，无法得到合法的实例对象

另外你的receive(on: DispatchQueue.global(qos: .background))逻辑存在隐患：@Published属性如果用于驱动UI更新，必须在主线程修改，否则会触发UI渲染异常。

修复方案 #

根据你的接口返回类型选择对应修复方式：

情况1：接口返回T类型的数组（对应你当前声明的result = [T]()） #

import Combine

class Fetcher<T: Codable>: ObservableObject {
    private var task: AnyCancellable?
    @Published var result = [T]()

    // 移除init前重复的泛型声明
    init(type: T.Type) {
        guard let url = URL(string: "https://api.example.com") else { return }
        task = URLSession.shared.dataTaskPublisher(for: url)
            .map(\.data)
            // 解码类型改为数组类型[T].self，和result类型匹配
            .decode(type: [T].self, decoder: JSONDecoder())
            // 修改为主线程接收，保证@Published属性更新安全
            .receive(on: DispatchQueue.main)
            // 解码失败时返回空数组作为默认值
            .replaceError(with: [])
            .assign(to: \.result, on: self)
    }
}

情况2：接口返回单个T实例 #

import Combine

class Fetcher<T: Codable>: ObservableObject {
    private var task: AnyCancellable?
    // 修改result为可选类型，无需强制转换
    @Published var result: T?

    init(type: T.Type) {
        guard let url = URL(string: "https://api.example.com") else { return }
        task = URLSession.shared.dataTaskPublisher(for: url)
            .map(\.data)
            .decode(type: T.self, decoder: JSONDecoder())
            .receive(on: DispatchQueue.main)
            // 解码失败时返回nil
            .replaceError(with: nil)
            .assign(to: \.result, on: self)
    }
}

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