NEHotspotHelper认证状态下无法发送Web请求问题求助

看起来你在NEHotspotHelper的认证流程里踩了几个常见的坑，咱们一步步来解决：

首先分析你的错误原因 #

你遇到的dnssd_clientstub read_all(7) DEFUNCT和error code: -1003，主要是三个问题导致的：

1. 阻塞了NEHotspotHelper的系统队列：你用DispatchSemaphore.wait把系统给热点助手的回调队列堵死了，系统会认为你的响应超时，直接中断网络请求。
2. 错误的认证响应时机：在authenticate回调里立刻返回success，但此时你的网络请求还没开始执行，系统会误以为认证已经完成，后续的网络请求自然会失败。
3. URLSession配置不匹配 captive portal 环境：默认的会话配置会走系统代理，而认证阶段代理还未生效，导致请求发不出去。

修正后的代码实现 #

先改NEHotspotHelper的回调逻辑：

let registered = NEHotspotHelper.register(options: options, queue: queue) { (cmd: NEHotspotHelperCommand) in
    print("Received command: \(cmd.commandType.rawValue)")
    switch cmd.commandType {
    case .filterScanList:
        print("filter scan list")
        guard let list = cmd.networkList else {
            let response = cmd.createResponse(.failure)
            response.deliver()
            return
        }
        // 只保留目标SSID并标记为高优先级
        let filteredList = list.filter { $0.ssid == "my-ssid" }
        filteredList.forEach { $0.setConfidence(.high) }
        let response = cmd.createResponse(.success)
        response.setNetworkList(filteredList)
        response.deliver()
        
    case .evaluate:
        guard let network = cmd.network, network.ssid == "my-ssid" else {
            let response = cmd.createResponse(.failure)
            response.deliver()
            return
        }
        network.setConfidence(.high)
        let response = cmd.createResponse(.success)
        response.setNetwork(network)
        response.deliver()
        
    case .authenticate:
        print("authenticate")
        guard let network = cmd.network, network.ssid == "my-ssid" else {
            let response = cmd.createResponse(.failure)
            response.deliver()
            return
        }
        
        // 先告诉系统：我们正在认证，请等待
        let inProgressResponse = cmd.createResponse(.authenticating)
        inProgressResponse.setNetwork(network)
        inProgressResponse.deliver()
        
        // 把认证请求放到后台队列，绝不阻塞系统回调队列
        DispatchQueue.global(qos: .background).async { [weak self] in
            self?.performPortalAuthentication(completion: { success in
                // 认证完成后，发送最终结果给系统
                let finalResponse = cmd.createResponse(success ? .success : .failure)
                finalResponse.setNetwork(network)
                finalResponse.deliver()
            })
        }
        
    default:
        let response = cmd.createResponse(.failure)
        response.deliver()
    }
}

然后重写你的网络请求方法，适配 captive portal 环境：

func performPortalAuthentication(completion: @escaping (Bool) -> Void) {
    // 使用临时会话配置，避免缓存和系统代理干扰
    let config = URLSessionConfiguration.ephemeral
    config.allowsCellularAccess = false
    // 清空代理配置，直接请求目标IP
    config.connectionProxyDictionary = [:]
    
    let session = URLSession(configuration: config)
    guard let url = URL(string: "https://172.217.20.35") else {
        completion(false)
        return
    }
    
    let task = session.dataTask(with: url) { data, response, error in
        defer {
            // 无论成功失败，都通知认证结果
            completion(error == nil && data != nil)
        }
        
        if let error = error {
            print("认证请求失败：\(error.localizedDescription) 错误码：\(error._code)")
            return
        }
        
        guard let httpResponse = response as? HTTPURLResponse, (200...299).contains(httpResponse.statusCode) else {
            print("服务器响应无效")
            if let httpResponse = response as? HTTPURLResponse {
                print("状态码：\(httpResponse.statusCode)")
            }
            return
        }
        
        print("认证请求成功！")
        if let data = data, let content = String(data: data, encoding: .utf8) {
            print("响应内容：\(content)")
            // 在这里解析WISPR响应，执行后续API认证逻辑
        }
    }
    task.resume()
}

关键注意事项 #

1. 绝对不要阻塞NEHotspotHelper的队列：系统给的队列是用来处理热点命令的，一旦阻塞，系统会直接中断你的助手进程。所有异步操作（比如网络请求）都要放到自己的后台队列里。
2. 分阶段返回响应：认证开始时返回.authenticating，等请求完成后再返回最终的success或failure，这是符合NEHotspotHelper规范的流程。
3. 适配 captive portal 的网络配置：用ephemeral配置+清空代理字典，可以绕过系统在认证阶段的代理限制，直接发送请求到目标IP。
4. 证书问题：如果目标服务器用的是自签名HTTPS证书，你可能需要临时禁用SSL验证（仅测试环境使用，正式环境务必使用可信证书）。

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