Swift 4.1项目迁移后调用download方法遇参数标签不匹配错误

嘿，我来帮你搞定这个迁移后的报错！这个Argument labels '(_:, destination:)' do not match any available overloads错误主要有两个核心原因：参数类型不匹配和Swift 4.1对参数标签的严格要求，另外还有一些GCD和URLSession的API命名变化需要同步适配。

问题根源拆解 #

你的public download方法最后调用download(encodedURLRequest, destination: destination)时，犯了两个小错误：

1. 类型不匹配：private方法的第一个参数要求是Downloadable枚举类型，但你直接传了URLRequest实例；
2. 标签不匹配：private方法第一个参数的外部标签是downloadable:，但调用时没有显式指定，Swift 4.1对参数标签的校验比旧版本更严格。

另外，迁移到Swift 4.1后，Objective-C风格的GCD、URLSession API已经被Swift化，旧方法名会触发编译警告甚至报错。

分步解决方案 #

1. 修正public方法对private download的调用 #

把encodedURLRequest包装成Downloadable.Request枚举值，同时显式指定downloadable:参数标签：

public func download(
    method: Method,
    _ URLString: URLStringConvertible,
    parameters: [String: AnyObject]? = nil,
    encoding: ParameterEncoding = .URL,
    headers: [String: String]? = nil,
    destination: Request.DownloadFileDestination)
    -> Request {
    let mutableURLRequest = URLRequest(method: method, URLString, headers: headers)
    let encodedURLRequest = encoding.encode(URLRequest: mutableURLRequest, parameters: parameters).0
    // 关键修正：包装枚举类型+匹配参数标签
    return download(downloadable: .Request(encodedURLRequest), destination: destination)
}

2. 更新private方法中的Swift 4.1适配API #

把旧的Objective-C风格API替换成Swift化的方法：

private func download(downloadable: Downloadable, destination: Request.DownloadFileDestination) -> Request {
    var downloadTask: URLSessionDownloadTask!
    switch downloadable {
    case .Request(let request):
        // 替换GCD的dispatch_sync为Swift的queue.sync
        queue.sync {
            // 替换URLSession旧方法名
            downloadTask = self.session.downloadTask(with: request)
        }
    case .ResumeData(let resumeData):
        queue.sync {
            downloadTask = self.session.downloadTask(withResumeData: resumeData)
        }
    }
    let request = Request(session: session, task: downloadTask)
    if let downloadDelegate = request.delegate as? Request.DownloadTaskDelegate {
        downloadDelegate.downloadTaskDidFinishDownloadingToURL = { session, downloadTask, url in
            // 替换NSHTTPURLResponse为Swift原生的HTTPURLResponse
            return destination(url, downloadTask.response as! HTTPURLResponse)
        }
    }
    delegate[request.delegate.task] = request.delegate
    if startRequestsImmediately {
        request.resume()
    }
    return request
}

3. 可选优化：简化参数标签（按需选择） #

如果你觉得每次写downloadable:标签太繁琐，可以修改private方法的参数定义，用_省略外部标签：

// 修改参数标签为_，调用时可省略downloadable:
private func download(_ downloadable: Downloadable, destination: Request.DownloadFileDestination) -> Request {
    // 方法体保持不变
}

这样public方法的调用可以简化为：

return download(.Request(encodedURLRequest), destination: destination)

完成以上修改后，重新编译应该就能解决参数标签不匹配的问题，同时也完全适配了Swift 4.1的API规范。

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