You need to enable JavaScript to run this app. Ratchet PHP Websocket服务端连接正常但Kotlin客户端未收到连接确认如何解决?
优惠活动
大模型
产品
解决方案
定价
更多

Ratchet PHP Websocket服务端连接正常但Kotlin客户端未收到连接确认如何解决?

核心问题根因

你遇到的连接异常本质是两端协议不匹配:

  • 你用Ratchet搭建的是标准原生WebSocket服务,仅实现了RFC6455规定的基础WebSocket握手和帧传输逻辑
  • Kotlin端使用的socket-io-java是Socket.IO协议的专用客户端,Socket.IO是基于WebSocket(兼容降级轮询)的上层封装协议,有独立的握手、心跳、消息封装规则。哪怕你强制指定传输层用WebSocket,它也不会把原生WebSocket的连接完成事件当做连接成功标志,必须等服务端返回Socket.IO协议规定的握手确认包才会触发EVENT_CONNECT事件。

这也能解释你的测试现象:Chrome用原生WebSocket客户端测试时协议匹配,可以正常连接;Socket.IO客户端只会等待专属握手包,收不到就判定超时断开重连。Brave浏览器无法触发原生WebSocket连接日志大概率是浏览器隐私防护、扩展拦截了WebSocket请求,和Android端问题无关。


解决方案二选一即可

方案1:Kotlin端改用原生WebSocket客户端,和服务端协议匹配

弃用socket-io-java库,直接用OkHttp这类通用WebSocket客户端实现,逻辑和你Chrome的测试代码一致,就能正常触发连接成功事件。
示例实现代码:

// 先在build.gradle引入OkHttp依赖
// implementation 'com.squareup.okhttp3:okhttp:4.12.0'

val client = OkHttpClient()
val request = Request.Builder().url("ws://<my-ip>:80").build()
val webSocketListener = object : WebSocketListener() {
    override fun onOpen(webSocket: WebSocket, response: Response) {
        super.onOpen(webSocket, response)
        Log.d(TAG, "[INFO] Connection established")
        webSocket.send(jsonObject.toString())
    }

    override fun onMessage(webSocket: WebSocket, text: String) {
        super.onMessage(webSocket, text)
        Log.d(TAG, "收到消息:$text")
    }

    override fun onFailure(webSocket: WebSocket, t: Throwable, response: Response?) {
        super.onFailure(webSocket, t, response)
        Log.e(TAG, "连接出错", t)
    }

    override fun onClosing(webSocket: WebSocket, code: Int, reason: String) {
        super.onClosing(webSocket, code, reason)
        webSocket.close(1000, null)
    }
}
client.newWebSocket(request, webSocketListener)

方案2:服务端改用Socket.IO兼容的PHP实现,匹配客户端协议

如果你需要保留Socket.IO的能力(自动重连、消息确认、房间广播等),就不要使用Ratchet的原生WsServer,改用workerman/phpsocket.io这类PHP版Socket.IO服务端实现,完全兼容Socket.IO客户端协议,就能正常触发EVENT_CONNECT事件。


额外排查点

如果选择方案1后仍无法正常连接,优先排查两个Android端常见问题:

  • 确认AndroidManifest.xml已经添加网络权限:<uses-permission android:name="android.permission.INTERNET" />
  • Android 9及以上版本默认禁止明文HTTP/WS请求,需要在AndroidManifest.xml的application节点添加android:usesCleartextTraffic="true"才能正常访问ws协议地址
  • 1024以下端口需要系统权限才能绑定,建议换用8080这类高位端口测试,避免Ratchet没有权限绑定80端口的问题

内容的提问来源于stack exchange,提问作者Sarah Multitasker

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.21 04:27:01