iOS模拟器无法通过Swift原生URLSessionWebSocketTask连接本地WebSocket

针对你遇到的原生URLSessionWebSocketTask无法连接本地ws://localhost:5000服务器，但socket.io可以正常连接的问题，以下是几个常见原因及对应解决办法：

1. URLSession默认配置的隐含限制 #

URLSession.shared使用系统默认配置，可能存在未明确的超时或连接限制。尝试自定义配置，消除潜在限制：

let config = URLSessionConfiguration.default
config.timeoutIntervalForRequest = 30
config.timeoutIntervalForResource = 30
config.waitsForConnectivity = true

// 自定义Session并绑定代理
let session = URLSession(configuration: config, delegate: self, delegateQueue: .main)
webSocketTask = session.webSocketTask(with: URL(string: "ws://localhost:5000")!)
webSocketTask.resume()

2. 代理方法未完整实现 #

你设置了代理但未实现核心回调，无法捕获连接失败的具体原因。必须添加以下代理方法排查问题：

extension YourViewController: URLSessionWebSocketDelegate {
    func urlSession(_ session: URLSession, webSocketTask: URLSessionWebSocketTask, didOpenWithProtocol protocol: String?) {
        print("WebSocket连接成功")
    }
    
    func urlSession(_ session: URLSession, webSocketTask: URLSessionWebSocketTask, didCloseWith closeCode: URLSessionWebSocketTask.CloseCode, reason: Data?) {
        let reasonStr = String(data: reason ?? Data(), encoding: .utf8) ?? "未知"
        print("连接关闭：错误码\(closeCode)，原因：\(reasonStr)")
    }
    
    func urlSession(_ session: URLSession, task: URLSessionTask, didCompleteWithError error: Error?) {
        if let error = error {
            print("连接失败详情：\(error.localizedDescription)")
        }
    }
}

通过这些方法能直接获取连接失败的具体错误，比如协议不兼容、超时等。

3. 本地服务器的WebSocket标准兼容性 #

原生URLSessionWebSocketTask严格遵循RFC 6455标准，而socket.io自带协议兼容层（包含自定义握手、心跳逻辑）。如果你的本地服务器是为socket.io优化的，可能未完全实现标准WebSocket握手流程。

用curl测试服务器的标准兼容性：

curl -i -N -H "Connection: Upgrade" -H "Upgrade: websocket" -H "Host: localhost:5000" -H "Origin: http://localhost:5000" -H "Sec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==" -H "Sec-WebSocket-Version: 13" http://localhost:5000

若返回101 Switching Protocols响应，说明符合标准；否则需要调整服务器的WebSocket实现。

4. 模拟器网络解析异常 #

模拟器中localhost偶尔会出现解析问题，尝试改用主机的局域网IP（如ws://192.168.x.x:5000）代替localhost。

5. 未启动消息接收循环 #

原生WebSocketTask需要主动启动消息接收，否则连接后会因无交互被服务器断开。在连接成功后添加接收逻辑：

func urlSession(_ session: URLSession, webSocketTask: URLSessionWebSocketTask, didOpenWithProtocol protocol: String?) {
    print("连接成功，开始接收消息")
    receiveNextMessage()
}

private func receiveNextMessage() {
    webSocketTask.receive { [weak self] result in
        guard let self = self else { return }
        switch result {
        case .success(let message):
            print("收到消息：\(message)")
            // 持续接收下一条消息
            self.receiveNextMessage()
        case .failure(let error):
            print("接收消息失败：\(error)")
        }
    }
}

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