Swift中如何进行URL编码？嵌套URL作为查询参数时的编码问题

嘿，我之前也踩过这个坑！你遇到的问题其实是对urlQueryAllowed这个字符集的作用理解有点偏差~

你直接给整个长URL调用addingPercentEncoding(withAllowedCharacters: .urlQueryAllowed)时，嵌套的那部分URL没有被编码，是因为urlQueryAllowed本身就允许://、?这些URL里的常见特殊字符——毕竟查询参数里偶尔也会用到这些字符。但我们的需求是把整个嵌套URL当成一个完整的参数值，这些字符就会导致主URL的解析器混乱（比如把嵌套URL里的?当成主URL的新参数分隔符），所以必须把这些字符也编码掉。

下面给你两种靠谱的解决方法：

方法一：单独编码嵌套URL参数值，再手动拼接 #

这种方式适合你已经有明确的主URL结构，只想替换某个参数的场景：

// 先准备好要作为参数的嵌套URL
let nestedUrlString = "https://www.apple.com/path2?param2=asdf"

// 定义严格的允许字符集：只保留RFC 3986规定的"未保留字符"（A-Za-z0-9-._~）
let allowedChars = CharacterSet(charactersIn: "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789-._~")

// 对嵌套URL进行编码
guard let encodedNestedUrl = nestedUrlString.addingPercentEncoding(withAllowedCharacters: allowedChars) else {
    print("嵌套URL编码失败")
    return
}

// 拼接成最终的URL字符串
let finalUrl = "https://www.google.com/path1?param1=\(encodedNestedUrl)"
print(finalUrl)
// 输出就是你期望的结果：https://www.google.com/path1?param1=https%3A%2F%2Fwww.apple.com%2Fpath2%3Fparam2%3Dasdf

方法二：用URLComponents构建URL（推荐） #

这是苹果官方更推荐的方式，它会自动按照RFC规范处理参数编码，完全不用手动操心拼接和编码的细节：

// 1. 初始化主URL的components
guard var mainComponents = URLComponents(string: "https://www.google.com/path1") else {
    print("主URL格式错误")
    return
}

// 2. 创建查询参数：把嵌套URL直接作为param1的值
let nestedUrl = "https://www.apple.com/path2?param2=asdf"
let queryItem = URLQueryItem(name: "param1", value: nestedUrl)

// 3. 将参数添加到主URL的components中
mainComponents.queryItems = [queryItem]

// 4. 获取最终编码后的URL
if let finalEncodedUrl = mainComponents.url?.absoluteString {
    print(finalEncodedUrl)
    // 输出和上面方法一致的正确编码结果
}

小总结 #

• 别直接对整个完整URL调用urlQueryAllowed编码，它的宽松规则不适合嵌套URL的场景；
• 优先用URLComponents来构建带参数的URL，既能避免编码错误，也让代码更易维护。

内容来源于stack exchange