Swift 5中NSURLComponents将?编码为%3F致请求失败，如何解决？

我来帮你搞定这个问题！你遇到的核心问题是错误地把包含查询参数的内容放到了path属性里，导致NSURLComponents自动编码了?，最终请求找不到目标资源。

问题根源 #

当你把"/service/getData?cc=al&lastDate="直接赋值给urlComponents.path时，NSURLComponents会把整个字符串当作URL的路径部分处理。而?属于URL路径中的特殊字符，会被自动编码成%3F，服务器收到的请求路径就变成了/service/getData%3Fcc=al&lastDate=——这显然不是你要的接口地址，所以服务器返回Not Found的HTML页面，后续的JSON解码自然会失败（因为拿到的不是预期的JSON数据）。

正确的解决方案：拆分路径和查询参数 #

NSURLComponents专门提供了queryItems属性来管理查询参数，它会自动帮你处理?和&的拼接，完全不需要手动在路径里加?。修改你的代码如下：

// 注：host和path实际来自info.plist，此处为示例值
let host = "servicehost.com"
// 只保留纯粹的路径部分，去掉?和后面的查询参数
let purePath = "/service/getData"

let urlComponents = NSURLComponents()
urlComponents.scheme = "https"
urlComponents.host = host
urlComponents.path = purePath

// 通过queryItems添加查询参数
urlComponents.queryItems = [
    URLQueryItem(name: "cc", value: "al"),
    URLQueryItem(name: "lastDate", value: "") // 如果lastDate有具体值，替换成对应内容即可
]

// 生成正确的URL
if let url = urlComponents.url {
    print(url.absoluteString) // 输出：https://servicehost.com/service/getData?cc=al&lastDate=
}

额外方案：手动拼接URL字符串（不推荐） #

如果你一定要手动拼接完整的URL字符串，可以直接用URL(string:)初始化，但这种方式需要自己确保参数的编码正确性（比如参数值里有特殊字符时容易出问题），示例如下：

let host = "servicehost.com"
let purePath = "/service/getData"
let fullUrlString = "https://\(host)\(purePath)?cc=al&lastDate="

if let url = URL(string: fullUrlString) {
    // 使用该URL发起请求
}

总结 #

推荐优先使用queryItems的方式，它不仅能避免?被错误编码的问题，还能自动处理参数值中的特殊字符（比如空格、&等），让URL构造更安全可靠。你之前遇到的解码错误，本质是因为请求返回的是HTML错误页面，而非预期的JSON数据，修复URL构造方式后就能解决问题啦。

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