cocos creator 3.8.6 websocke的一直报错WebSocket is not a constructor
WebSocket is not a constructor
在cocos creator 3.8.6 构建的安卓应用中,使用了websocket,在运行过程中一直报 WebSocket is not a constructor
解决方法:
. 官方说明
Cocos Creator 3.x(包括 3.8.6)原生平台(Android/iOS)WebSocket 支持,官方文档说明如下:
原生平台:WebSocket 由引擎自动注入,直接用 window.WebSocket 或全局 WebSocket 即可,不需要 WebSocket。
但你遇到 WebSocket is not a constructor,说明全局 WebSocket 没有被注入,可能是构建配置或引擎 bug。
2. 解决思路
方案一:确认网络模块是否被裁剪
检查构建面板 → 模块设置
确认“网络”模块(network)已勾选。
如果未勾选,原生包不会包含 WebSocket 支持。
重新构建并安装到设备测试
勾选后重新构建、编译、安装。
用法示例
if (sys.isNative && sys.platform === sys.Platform.ANDROID) { console.log(\'Android平台特殊处理\', this.host); // Android平台特殊处理 //const cert: string = \'cert/cert.pem\'; // TODO: 处理证书路径 this.ws = new WebSocket(this.host!, \"ws\"); //this.ws = new jsb.WebSocket(this.host!,\"ws\"); } else { console.log(\'其他平台特殊处理\', this.host); this.ws = new WebSocket(this.host!); }
方案二:用 cc.Socket(Cocos 3.8.6 新增)
Cocos Creator 3.8.x 开始,原生平台推荐用 cc.Socket,不是 WebSocket。
用法示例
import { sys, Socket } from \'cc\';private initSocket(): void { if (!this.ws) { if (sys.isNative && sys.platform === sys.Platform.ANDROID) { console.log(\'Android平台特殊处理\', this.host); this.ws = new Socket(); // 解析 host 和 port const url = new URL(this.host!); this.ws.connect(url.hostname, Number(url.port)); } else { console.log(\'其他平台特殊处理\', this.host); this.ws = new window.WebSocket(this.host!); } // 事件绑定(cc.Socket 事件和 WebSocket 不完全一样) this.ws.on(\'open\', this.connected.bind(this)); this.ws.on(\'message\', this.message.bind(this)); this.ws.on(\'close\', this.close.bind(this)); this.ws.on(\'error\', this.error.bind(this)); this.notification = new EventTarget(); } else { // ... 你的原有逻辑 ... }}
注意:
cc.Socket 只支持原生平台,Web 端还是用 WebSocket。
事件名和标准 WebSocket 不一样,需用 on(‘open’, …) 这种方式。
方案三:自定义全局 WebSocket
如果你项目里有 polyfill 或第三方库覆盖了全局 WebSocket,请检查是否有类似代码,避免冲突。
3. 总结
优先推荐用 cc.Socket,这是 Cocos Creator 3.8.x 官方推荐的原生网络通信方式。
构建时确保“网络”模块已勾选,否则原生包没有网络能力。
Web 端用 window.WebSocket,原生端用 cc.Socket。