Swift中NSURLComponents处理含特殊字符密码的NTML认证问题

问题核心：NSURLComponents会自动对用户名和密码做URL百分号编码，但NTLM认证要求使用原始凭证字符串，编码后的密码无法被服务端识别，导致认证失败。

方案一：使用URLSession认证挑战处理NTLM（推荐） #

这是苹果官方推荐的NTLM认证处理方式，完全避开URL编码问题，同时更安全（凭证不会暴露在URL中）。

实现步骤： #

1. 构造不带凭证的基础URL和请求
2. 配置URLSession并实现delegate方法，在收到认证挑战时提供NTLM凭证

代码示例：

let targetURL = URL(string: "https://example.com/api/")!
var request = URLRequest(url: targetURL)

// 配置Session并设置代理
let sessionConfig = URLSessionConfiguration.default
let session = URLSession(configuration: sessionConfig, delegate: self, delegateQueue: .main)

// 发起请求
let task = session.dataTask(with: request) { data, response, error in
    // 处理接口响应逻辑
}
task.resume()

// 实现URLSessionDelegate的认证挑战方法
extension YourClass: URLSessionDelegate {
    func urlSession(_ session: URLSession, didReceive challenge: URLAuthenticationChallenge, completionHandler: @escaping (URLSession.AuthChallengeDisposition, URLCredential?) -> Void) {
        // 判断是否为NTLM认证挑战
        guard challenge.protectionSpace.authenticationMethod == NSURLAuthenticationMethodNTLM else {
            completionHandler(.performDefaultHandling, nil)
            return
        }
        // 提供原始凭证
        let credential = URLCredential(user: "username", password: "p@ssword", persistence: .forSession)
        completionHandler(.useCredential, credential)
    }
}

方案二：手动构造未编码的URL字符串（仅适用于密码无URL敏感字符） #

如果必须通过URL携带凭证，可手动拼接未编码的凭证字符串，但要注意：若密码包含@、/等会破坏URL结构的字符，此方法会导致URL初始化失败，因此仅作为临时替代方案。

代码示例：

let username = "username"
let password = "p@ssword"
let baseHostPath = "example.com/api/"

// 手动拼接未编码的凭证URL
guard let url = URL(string: "https://\(username):\(password)@\(baseHostPath)") else {
    // 处理URL无效的情况，比如密码含敏感字符
    return
}

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