调用apiRequest报错：静态方法要求NSDictionary遵循Encodable协议如何解决？

问题根源 #

你的apiRequest方法要求传入的params泛型参数必须遵守Encodable协议，但你传入的NSDictionary（包括Swift原生的[String: Any]）本身并不遵守Encodable——因为Any类型没有实现Encodable，编译器无法动态判断运行时Any存储的实际类型要如何编码，你做的params as NSDictionary转换对解决协议遵守问题没有任何作用。

解决方案 #

方案1：使用强类型结构体传参（推荐） #

如果你的业务场景可以提前确定参数结构，直接定义遵守Encodable的结构体代替[String: Any]，既可以解决编译错误，还能享受类型安全检查：

// 示例：根据业务实际参数定义对应结构体
struct QueryParams: Encodable {
    let name: String
    let page: Int
}

然后把apiCall方法的params参数也改成泛型约束：

static func apiCall<Params: Encodable>(
    method: String,
    params: Params,
    connectionString: String,
    authToken: String? = nil,
    completion: @escaping ([String: Any]?, Error?) -> Void
) {
    // 原有内部逻辑不需要修改
}

调用时直接传入结构体实例即可，完全规避动态字典的类型风险。

方案2：兼容动态[String: Any]场景 #

如果业务确实需要传递结构不固定的动态字典，可以实现一个通用的Encodable包装器来处理Any类型编码：

struct AnyEncodable: Encodable {
    let value: Any
    
    func encode(to encoder: Encoder) throws {
        var container = encoder.singleValueContainer()
        // 根据业务需要补充支持的编码类型
        if let intValue = value as? Int {
            try container.encode(intValue)
        } else if let stringValue = value as? String {
            try container.encode(stringValue)
        } else if let doubleValue = value as? Double {
            try container.encode(doubleValue)
        } else if let boolValue = value as? Bool {
            try container.encode(boolValue)
        } else if let arrayValue = value as? [Any] {
            try container.encode(arrayValue.map { AnyEncodable(value: $0) })
        } else if let dictValue = value as? [String: Any] {
            try container.encode(dictValue.mapValues { AnyEncodable(value: $0) })
        } else {
            throw EncodingError.invalidValue(value, EncodingError.Context(codingPath: encoder.codingPath, debugDescription: "不支持的参数类型"))
        }
    }
}

修改apiCall中调用apiRequest的传参代码即可：

req = try apiRequest(
    method: method,
    params: AnyEncodable(value: params), // 替换原来的params as NSDictionary
    url: URL(string: connectionString)!,
    authToken: authToken
)

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