Android OkHttp3连接Socket服务器报错：HTTP 101响应异常（404）

数据老陈

2026-8-11

解决OkHttp3连接WebSocket时出现java.net.ProtocolException: Expected HTTP 101 response but was '404 Not Found'的问题

问题原因

你当前使用的https://协议头不符合WebSocket规范，WebSocket连接应使用ws://（明文）或wss://（加密）作为协议前缀
SocketIO库会自动处理WebSocket连接的路径转换与参数拼接，而OkHttp需要你明确指定服务器端SocketIO对应的WebSocket端点路径（SocketIO默认端点为/socket.io/，且需附带协议版本等查询参数）

解决方案

将URL协议头替换为wss://（匹配原https的加密连接场景）
补充SocketIO的WebSocket端点路径及必要参数，完整URL格式应为：wss://url.com:3003/socket.io/?EIO=4&transport=websocket（EIO版本号需与服务器端SocketIO版本对应，通常v4版本对应EIO=4）

修改后的代码

private fun run() {
    val client: OkHttpClient = OkHttpClient.Builder()
        .readTimeout(3, TimeUnit.SECONDS)
        .build()
    // 使用正确的SocketIO WebSocket端点URL
    val socketUrl = "wss://url.com:3003/socket.io/?EIO=4&transport=websocket"
    val request: Request = Request.Builder()
        .url(socketUrl)
        .build()
    client.newWebSocket(request, this)
    client.dispatcher.executorService.shutdown()
}