下表仅供参考, 如果问题紧急, 请 发工单至 support.colyseus.io.
| 报错 | 原因 | 解决 |
|---|---|---|
errno: -4058 spawn git ENOENT |
找不到Git命令 | 安装Git/配置Git路径 |
XXX has been blocked by CORS policy |
http请求试图调用https资源/本地试图访问网络资源/Arena上传代码后没有部署/在已连接服务器的情况下重复连接 | 统一使用https/配置跨域访问政策文件/Arena上传代码后记得点击'deploy' /避免重复连接服务器 |
SyntaxError: Unexpected token '.' |
NodeJS版本太旧 | 升级NodeJS |
MissingMethodException: Default constructor not found |
引擎代码被删减 | 尝试关闭 code stripping |
TypeError: Cannot assign to read only property 'map' of object '#<QueryCursor>' |
NodeJS版本太旧 | 升级NodeJS |
Error: missing serializer |
客户端/服务器版本不一致 | 统一SDK到当前版本 |
Error: seat reservation expired |
客户端与服务器版本不匹配/客户端未实例化或数量过大/redis驱动不匹配/matchAPI无法正常工作/服务器URL端口不对或者是URL后多打了一个"/" | 升级客户端/等待客户端完成实例化/升级服务端容量/升级redis驱动/更正URL |
Class constructor Room cannot be invoked without 'new' |
Typescript编译版本过低 | 配置Typescript编译目标 "es2015" 或更高 |
Type 'number[]' is missing the following properties from type 'ArraySchema<number>' |
schema类型写错 | ArraySchema<number>的类型是number[] |
ERROR in XXX.d.ts ... XXX expected |
Typescript版本过低 | 升级Typescript: npm install --save-dev typescript@latest |
npm ERR! Could not resolve XXX |
npm命令执行错误 | 重新安装相关依赖模块 |
net::ERR_SSL_PROTOCOL_ERROR |
使用了ip地址进行SSL连接 | 改用https://domain进行连接 |
TypeError: Cannot read properties of undefined (reading 'prototype') |
依赖库版本不匹配 | 尝试运行 npm update 命令 |
Right-hand side of 'instanceof' is not callable |
schema类型写错 | 检测并修复schema |
IPC timed out. method: undefined |
Room代码有错 | 检查Room及其定义相关代码 |
net::ERR_CERT_AUTHORITY_INVALID |
端口配置与Arena不符 | Arena上使用https地址不要加端口号 |
Error: read ECONNRESET |
套接字连接超时 | 增强网络稳定性/添加套接字错误处理 |
502 bad gateway |
Linux权限问题 | 关闭SELINUX |
SSL Handshake Failed |
客户端host没有SSL证书 | 上传到拥有SSL证书的host上再打开 |
socket shut down code 1000 |
如果是意外行为的话大概率代码有错 | 检查修复代码 |
xx room is already full |
本地/远程服务器使用了同一个数据库 | 让本地开发服务器使用本地数据库 |