使用Socket.io通过wss协议连接服务器报错求助

核心问题分析 #

相同WSS URL下，原生WebSocket连接正常，但Socket.io客户端（2.1.0版本）连接报错，需从以下几个方向逐一排查：

1. 错误的URL参数：手动添加了Socket.io握手参数 #

你当前的URL包含EIO=4、sid、t等参数，这些是Socket.io握手阶段自动生成的参数，完全不需要手动拼在初始连接URL里。Socket.io客户端会自行完成握手流程并拼接这些参数。

修正方式：只保留基础服务地址，去掉所有查询参数：

private var url = "wss://xyz.com/primus/"

2. Socket.io客户端与服务器版本不兼容 #

Socket.io对版本匹配要求严格：2.x客户端必须对应2.x服务器，3.x及以上版本有协议变更。如果服务器端是3.x+版本，2.1.0客户端会因协议不兼容直接握手失败。

验证方式：

• 确认服务器端Socket.io版本，若版本不匹配，要么升级客户端到对应大版本，要么降级服务器版本。

3. 缺少必要的客户端配置选项 #

Socket.io默认会先尝试HTTP长轮询（polling）再升级到WebSocket，可能在轮询阶段出错导致连接失败。可强制指定仅用WebSocket传输，同时确保SSL配置正确：

init {
    try {
        val opts = IO.Options()
        // 强制使用websocket传输，跳过polling阶段
        opts.transports = arrayOf("websocket")
        // 明确启用SSL（WSS协议默认开启，但显式设置可避免环境差异）
        opts.secure = true
        // 若服务器使用自签名证书，可临时禁用证书验证（仅测试用，生产环境禁止）
        // opts.hostnameVerifier = HostnameVerifier { _, _ -> true }
        socket = IO.socket("wss://xyz.com/primus/", opts)
    } catch (e: Exception) {
        // 打印完整异常栈，定位具体错误根源
        Log.e("SocketInit", "初始化失败", e)
    }
}

4. 未捕获完整错误信息 #

当前EVENT_CONNECT_ERROR仅打印错误对象的toString，无法获取详细异常栈。需修改日志打印逻辑，获取完整错误详情：

socket?.on(Socket.EVENT_CONNECT_ERROR) { args ->
    val error = args.firstOrNull()
    if (error is Exception) {
        Log.e("SocketError", "连接失败", error)
    } else {
        Log.e("SocketError", "连接失败: ${error.toString()}")
    }
}

5. 服务器使用Primus框架，Socket.io客户端兼容性问题 #

URL中的primus表明服务器可能用的是Primus（一个兼容多种实时协议的框架），而非原生Socket.io。Socket.io客户端与Primus服务器直接连接可能存在协议兼容问题，建议：

• 改用Primus官方客户端库进行连接；
• 确认服务器是否同时兼容Socket.io协议。

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