使用Alamofire的iOS应用出现URLSessionTask域名解析失败问题求助

问题背景 #

我开发的iOS应用使用Alamofire发起网络请求，部分用户反馈无法正常使用，请求时收到错误提示：

"URLSessionTask failed with error: A server with the specified host could not be found."

我在弱网、无网、蜂窝数据等多种环境测试均正常，无法复现该问题，但有iPhone 14（iOS 16）用户上报此情况。相关核心代码如下：

static func postUserToAPI(params: Parameters, headers: Alamofire.HTTPHeaders, completion: @escaping (Error?) -> ()) {
        AF.request(URL.EndPoints.userURL, method: .post, parameters: params, encoding: JSONEncoding.default, headers: headers)
            .validate()
            .response { response in               
                if response.error == nil {
                    completion(nil)
                }
        
                else {
                    completion(response.error)
                }                
            }
 }

可能成因 #

• DNS解析异常：部分用户的网络环境（比如特定运营商、公共WiFi）存在DNS污染或解析故障，导致无法识别API域名；iOS 16的DNS缓存机制、网络配置逻辑和旧系统有差异，iPhone 14的硬件网络模块也可能在特定场景下出现解析问题。
• URL格式问题：如果URL.EndPoints.userURL是动态拼接生成的，可能存在部分用户场景下生成的URL不合法（比如多了空格、特殊字符，或者缺失http/https协议头），而测试环境没覆盖到该场景。
• 网络权限限制：部分用户设备开启了系统级VPN、防火墙，或者误关了应用的网络权限；iOS 16的隐私权限逻辑有更新，若应用权限申请不彻底，也可能导致网络请求被拦截。
• 缺少容错配置：当前代码没有针对DNS解析失败的情况做重试或兜底处理，单次解析失败就直接返回错误，没有缓冲空间。

预防与解决措施 #

• 提前校验URL合法性：发起请求前先检查目标URL的格式，避免无效地址导致的报错，示例代码：

static func postUserToAPI(params: Parameters, headers: Alamofire.HTTPHeaders, completion: @escaping (Error?) -> ()) {
    guard let targetURL = URL(string: URL.EndPoints.userURL), 
          targetURL.scheme != nil, 
          targetURL.host != nil else {
        let invalidURLError = NSError(domain: "InvalidURL", code: -1, userInfo: [NSLocalizedDescriptionKey: "请求地址无效"])
        completion(invalidURLError)
        return
    }
    
    AF.request(targetURL, method: .post, parameters: params, encoding: JSONEncoding.default, headers: headers)
        .validate()
        .response { response in               
            if let error = response.error {
                // 针对DNS错误做特殊处理
                if let afError = error as? AFError,
                   let urlError = afError.underlyingError as? URLError,
                   urlError.code == .cannotFindHost {
                    let dnsError = NSError(domain: "DNSFailure", code: urlError.code.rawValue, userInfo: [NSLocalizedDescriptionKey: "无法连接到服务器，请检查网络或尝试切换DNS"])
                    completion(dnsError)
                } else {
                    completion(error)
                }
            } else {
                completion(nil)
            }                
        }
}

• 配置自定义Session增强容错：给Alamofire配置带重试策略、自定义DNS的Session，提升网络请求的稳定性：

// 全局自定义Session
let sessionConfiguration = URLSessionConfiguration.default
sessionConfiguration.timeoutIntervalForRequest = 15
sessionConfiguration.timeoutIntervalForResource = 30
// 配置公共DNS服务器，比如Cloudflare或谷歌的DNS
sessionConfiguration.connectionProxyDictionary = [
    kCFNetworkProxiesProxyType: kCFProxyTypeNone,
    kCFNetworkProxiesDNS: ["1.1.1.1", "8.8.8.8"]
]
// 添加重试策略：针对DNS失败的情况重试2次
let retryPolicy = ExponentialBackoffRetryPolicy(retryLimit: 2, retryableErrorCodes: [URLError.cannotFindHost.rawValue])
let customSession = Session(configuration: sessionConfiguration, retryPolicy: retryPolicy)

// 使用自定义Session发起请求
customSession.request(targetURL, ...)

• 完善用户提示：在错误回调中针对DNS错误给出明确的引导提示，帮助用户自行排查问题。
• 扩展测试场景：测试时模拟DNS解析失败的情况（比如把设备DNS改成无效地址），同时覆盖iOS 16的特殊网络配置（比如低数据模式、VPN开启状态），确保测试场景贴近用户实际使用情况。
• 检查权限配置：确认Info.plist中正确配置了网络相关权限描述（比如NSLocalNetworkUsageDescription），如果使用HTTP协议，需配置NSAppTransportSecurity的例外规则，避免iOS 16的权限拦截。

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