Swift中APIManaging协议Mock实现的类型转换错误解决方案咨询

我正在开发一个包含APIManaging协议的项目，协议定义如下：

public protocol APIManaging {
    func execute<Value: Decodable>(_ request: Request<Value>) async -> Result<Value, APIError>
}

Request结构体定义：

public struct Request<Value> {
    public var method: Method
    public var path: String
    public var queryParams: [URLQueryItem]?

    public init(
        method: Method = .get,
        path: String,
        queryParams: [URLQueryItem]? = nil
    ) {
        self.method = method
        self.path = path
        self.queryParams = queryParams
    }
}

我尝试创建Mock对象APIManagingMock来实现该协议，但代码出现两个错误：

public final class APIManagingMock: APIManaging {
    public var stubbedResult: Result<Decodable, APIError> = .failure(.networkError)
    public private(set) var spyExecuteRequest: Request<Decodable>?

    public func execute<Value: Decodable>(_ request: Request<Value>) async -> Result<Value, APIError> {
        spyExecuteRequest = request // 错误1：Cannot assign value of type 'Request<Value>' to type 'Request<any Decodable>'
        return stubbedResult // 错误2：Cannot convert return expression of type 'Result<any Decodable, APIError>' to return type 'Result<Value, APIError>'
    }
}

错误详情：

• Cannot assign value of type 'Request<Value>' to type 'Request<any Decodable>'
• Cannot convert return expression of type 'Result<any Decodable, APIError>' to return type 'Result<Value, APIError>'

方案1：泛型Mock类（类型安全，推荐） #

让Mock类本身成为泛型类，和execute方法的泛型约束对齐，彻底解决类型不匹配问题：

public final class APIManagingMock<Value: Decodable>: APIManaging {
    public var stubbedResult: Result<Value, APIError> = .failure(.networkError)
    public private(set) var spyExecuteRequest: Request<Value>?

    public func execute(_ request: Request<Value>) async -> Result<Value, APIError> {
        spyExecuteRequest = request
        return stubbedResult
    }
}

这种方式完全符合Swift的类型系统，适合单个接口测试场景，每个测试用例可针对特定Value类型创建Mock实例。

方案2：通用Mock+类型映射 #

如果需要一个能处理任意Decodable类型的通用Mock，可以用字典存储不同类型的Stub结果，结合类型转换实现：

public final class APIManagingMock: APIManaging {
    private var stubbedResults: [ObjectIdentifier: Result<Decodable, APIError>] = [:]
    public private(set) var spyExecuteRequest: Any?

    // 提供方法设置特定类型的Stub结果
    public func setStubbedResult<Value: Decodable>(_ result: Result<Value, APIError>) {
        let typeKey = ObjectIdentifier(Value.self)
        stubbedResults[typeKey] = result.map { $0 as Decodable }
    }

    public func execute<Value: Decodable>(_ request: Request<Value>) async -> Result<Value, APIError> {
        spyExecuteRequest = request
        let typeKey = ObjectIdentifier(Value.self)
        
        guard let result = stubbedResults[typeKey] as? Result<Value, APIError> else {
            return .failure(.networkError)
        }
        return result
    }
}

使用时通过setStubbedResult指定对应类型的预期结果：

let mock = APIManagingMock()
mock.setStubbedResult(.success(MyTestModel(id: 1)))

这种方式适合需要在一个Mock中处理多种Decodable类型的场景，但需注意运行时类型转换的安全性。

方案3：Request协变（Swift 5.7+） #

如果你的Swift版本在5.7及以上，可以让Request的泛型参数支持协变，解决第一个赋值错误：

public struct Request<Value: any Decodable>: Covariant {
    public var method: Method
    public var path: String
    public var queryParams: [URLQueryItem]?

    public init(
        method: Method = .get,
        path: String,
        queryParams: [URLQueryItem]? = nil
    ) {
        self.method = method
        self.path = path
        self.queryParams = queryParams
    }
}

但此方案只能解决Request的类型转换问题，返回结果的类型不匹配仍需配合方案2的类型映射逻辑处理，单独使用价值有限。

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