URLRequest编码未正确处理特殊字符，求排查错误原因

嘿，我来帮你排查这个问题！通常URL里的特殊字符（比如&、=、空格这类）没正确编码，大多是因为直接手动拼接字符串生成URL，而没有用系统提供的标准编码工具。下面我给你拆解常见错误和正确的解决方式：

常见错误：手动拼接字符串 #

很多人会直接把参数拼接到URL字符串里，比如这样：

// 错误示例：参数值里的&会被当成参数分隔符，导致解析错误
let baseURL = "https://example.com/api"
let params = "name=John&age=30&note=Hello&World"
let urlString = baseURL + "?" + params
guard let url = URL(string: urlString) else { return }
let request = URLRequest(url: url)

这里note参数值里的&会被服务器误认为是新参数的分隔符，导致note的值被截断成Hello，还多出一个无效的World参数——这就是特殊字符未编码的典型问题。

正确做法：用URLComponents构建URL #

苹果官方推荐使用URLComponents来构建带参数的URL，它会自动帮你处理所有需要编码的特殊字符，完全不用手动操心：

// 正确示例：URLComponents自动编码特殊字符
var components = URLComponents(string: "https://example.com/api")!
components.queryItems = [
    URLQueryItem(name: "name", value: "John"),
    URLQueryItem(name: "age", value: "30"),
    URLQueryItem(name: "note", value: "Hello&World") // 这里的&会被自动转为%26
]

guard let url = components.url else { return }
let request = URLRequest(url: url)

生成的URL会是https://example.com/api?name=John&age=30&note=Hello%26World，服务器能正确解析出note的值是Hello&World。

手动编码的备选方案（不推荐） #

如果你非要手动编码单个参数值，可以用addingPercentEncoding(withAllowedCharacters:)方法，但要注意排除参数分隔符（&、=）：

// 手动编码参数值的示例
let rawNoteValue = "Hello&World"
// 从允许的URL查询字符集中移除&和=，确保这些字符被编码
let encodedNoteValue = rawNoteValue.addingPercentEncoding(withAllowedCharacters: .urlQueryAllowed.subtracting(CharacterSet(charactersIn: "&=")))

不过还是建议用URLComponents，它能处理所有边缘情况，比如空格、中文、特殊符号等，比手动编码靠谱得多。

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