cocos creator 3.8.6 websocke的一直报错WebSocket is not a constructor

发布于:2025-07-26 ⋅ 阅读:(17) ⋅ 点赞:(0)

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。


网站公告

今日签到

点亮在社区的每一天
去签到