# 客户端 SDK 错误码

错误码 KEY 描述
EC_SDK_SEND_FAIL 90001 消息发送失败
EC_SDK_UNINIT 90002 SDK 未初始化
EC_SDK_RES_TIMEOUT 90003 消息响应超时
EC_SDK_NO_LOGIN 90004 登录态错误
EC_SDK_NO_CHECK_LOGIN 90005 帧同步鉴权错误
EC_SDK_SOCKET_ERROR 90006 网络错误
EC_SDK_SOCKET_CLOSE 90007 Socket 断开
EC_SDK_NO_ROOM 90008 无房间

# 系统逻辑错误码

错误码 KEY 描述
EC_OK 0 返回成功
EC_REQ_BAD_PKG 1 请求包格式错误
EC_CMD_INVALID 2 非法命令字
EC_PARAMS_INVALID 3 参数错误
EC_INNER_ERROR 4 服务器内部错误
EC_TIME_OUT 5 后端超时错误
EC_SERVER_BUSY 6 服务器繁忙
EC_NO_RIGHT 7 没有权限请求
EC_ACCESS_CMD_INVALID_ERR 200 命令字无效错误
EC_ACCESS_CMD_GET_TOKEN_ERR 201 获取 Token 失败
EC_ACCESS_CMD_TOKEN_PRE_EXPIRE 202 Token 即将过期
EC_ACCESS_CMD_INVALID_TOKEN 203 Token 无效或过期
EC_ACCESS_PUSH_SERIALIZE_ERR 204 PUSH 序列化包失败
EC_ACCESS_LOGIN_BODY_PARSE_ERR 205 登录用户中心回包解析出错
EC_ACCESS_CONN_ERR 206 查找连接信息出错
EC_ACCESS_GET_RS_IP_ERR 207 获取 Relay 的 RS_IP 或 RS_PORT 出错
EC_ACCESS_ADD_COMM_CONN_ERR 208 添加 COMM 连接信息失败
EC_ACCESS_ADD_HEART_CONN_ERR 209 添加心跳连接信息失败
EC_ACCESS_ADD_RELAY_CONN_ERR 210 添加 Relay 连接信息失败
EC_ACCESS_HEART_BODY_PARSE_ERR 211 心跳包解析出错

# 用户中心错误

错误码 KEY 描述
EC_PLAYER_GAME_NOT_EXIST 10000 game 不存在
EC_PLAYER_SECRET_KEY_FAIL 10001 查询 secret_key 失败
EC_PLAYER_SIGN_ERR 10002 sign校验失败
EC_PLAYER_DUPLICATE_REQ 10003 重复请求
EC_PLAYER_TIMESTAMP_INVALID 10004 timestamp 非法
EC_PLAYER_QUERY_PLAYER_FAIL 10005 查询用户信息失败
EC_PLAYER_ADD_PLAYER_FAIL 10006 新增用户信息失败
EC_PLAYER_QUERY_GAME_FAIL 10007 查询 game 信息失败
EC_PLAYER_RECORD_NUM_ERR 10008 用户记录数不正确
EC_PLAYER_GET_TOKEN_FAIL 10009 查询 Token 失败
EC_PLAYER_TOKEN_NOT_EXIST 10010 Token 不存在
EC_PLAYER_TOKEN_INVALID 10011 Token 非法
EC_PLAYER_CLEAR_TOKEN_FAIL 10012 清除 Token 缓存失败
EC_PLAYER_LOCK_FAIL 10013 获取分布式锁失败
EC_PLAYER_UNLOCK_FAIL 10014 释放分布式锁失败
EC_PLAYER_SAVE_TOKEN_FAIL 10015 保存 Token 缓存失败

# 房间管理类错误

错误码 KEY 描述
EC_ROOM_CREATE_NO_PERMISSION 20000 创建房间无权限
EC_ROOM_DESTORY_NO_PERMISSION 20001 销毁房间无权限
EC_ROOM_JOIN_NO_PERMISSION 20002 无权限加入房间
EC_ROOM_REMOVE_PLAYER_NO_PERMISSION 20003 无踢人权限
EC_ROOM_MODIFY_PROPERTIES_NO_PEMISSION 20004 无修改房间属性权限
EC_ROOM_DISSMISS_NO_PERMISSION 20005 无解散房间权限
EC_ROOM_REMOVE_SELF_NO_PERMISSION 20006 无踢出自己权限
EC_ROOM_CHECK_LOGIN_SESSION_ERR 20007 检查登录失败
EC_ROOM_PLAYER_ALREADY_IN_ROOM 20010 用户已经在房间内,不能操作创建房间、加房等操作
EC_ROOM_PLAYER_NOT_IN_ROOM 20011 用户目前不在房间内,不能操作更改房间属性、踢人等操作
EC_ROOM_PLAYERS_EXCEED_LIMIT 20012 房间内用户数已经达到最大人数不能再加入了
EC_ROOM_JOIN_NOT_ALLOW 20013 房间不允许加入用户
EC_ROOM_MAX_PLAYERS_INVALID 20014 最大用户数值设置非法
EC_ROOM_CREATE_FAIL 20015 创建房间失败
EC_ROOM_PLAYER_OFFLINE 20016 用户在房间中掉线,不能开始游戏等操作
EC_ROOM_PARAM_PAGE_INVALID 20017 页号、页数大小参数不合法,可能实际大小没这么大
EC_ROOM_GET_PLAYER_INFO_ERR 20050 查询用户信息失败
EC_ROOM_GET_ROOM_INFO_ERR 20051 获取房间信息失败
EC_ROOM_QUERY_PLAYER_ERR 20060 查询用户信息失败
EC_ROOM_QUERY_GAME_ERR 20061 游戏信息失败
EC_ROOM_PLAYER_INFO_NOT_EXIST 20062 用户信息不存在
EC_ROOM_GAME_INFO_NOT_EXIST 20063 游戏信息不存在
EC_ROOM_REGION_INFO_NOT_EXIST 20065 查询不到 accessRegion 信息
EC_ROOM_QUERY_REGION_ERR 20066 查询地域信息失败
EC_ROOM_INFO_UNEXIST 20080 房间信息不存在
EC_ROOM_ALLOCATE_RELAYSVR_IP_PORT_ERR 20090 ctrlsvr 分配 relaysvr 失败
EC_ROOM_INVALID_PARAMS_TEAM_ID 20100 房间 teamId 无效
EC_ROOM_TEAM_MEMBER_LIMIT_EXCEED 20101 房间团队人员已满

# 匹配服务类错误

错误码 KEY 描述
EC_MATCH_NO_ROOM 30000 匹配失败,无任何房间
EC_MATCH_TIMEOUT 30001 匹配超时
EC_MATCH_LOGIC_ERR 30002 匹配逻辑错误
EC_MATCH_ERR 30010 匹配失败
EC_MATCH_PLAYER_IS_IN_MATCH 30011 用户已经在匹配中
EC_MATCH_PLAYER_NOT_IN_MATCH 30012 用户不在匹配状态
EC_MATCH_GET_MATCH_INFO_ERR 30013 获取匹配信息失败
EC_MATCH_UPDATE_MATCH_INFO_ERR 30014 更新匹配信息失败
EC_MATCH_CANCEL_FAILED 30015 取消匹配失败
EC_MATCH_GET_PLAYER_LIST_INFO_ERR 30016 查询匹配队列信息失败
EC_MATCH_CREATE_ROOM_ERR 30041 匹配创建房间失败
EC_MATCH_JOIN_ROOM_ERR 30042 匹配加入房间失败
EC_MATCH_QUERY_PLAYER_ERR 30100 查询用户信息失败
EC_MATCH_PLAYER_INFO_NOT_EXIST 30101 用户信息不存在
EC_MATCH_QUERY_GAME_ERR 30102 查询游戏信息失败
EC_MATCH_GAME_INFO_NOT_EXIST 30103 游戏信息不存在
EC_MATCH_QUERY_REGION_ERR 30104 查询大区信息失败
EC_MATCH_REGION_INFO_NOT_EXIST 30105 无大区信息
EC_MATCH_TEAM_FAIL 30106 团队匹配失败
EC_MATCH_PLAY_RULE_NOT_RUNNING 30107 匹配规则不可用
EC_MATCH_PLAY_ATTR_NOT_FOUND 30108 匹配参数不完整
EC_MATCH_PLAY_RULE_NOT_FOUND 30109 匹配规则不存在
EC_MATCH_PLAY_RULE_ATTR_SEGMENT_NOT_FOUND 30110 匹配规则获取属性匹配区间失败
EC_MATCH_PLAY_RULE_FUNC_ERR 30111 匹配规则算法错误
EC_MATCH_GET_PLAYER_ATTR_FAIL 30112 匹配获取玩家属性失败
EC_MATCH_GET_TEAM_ATTR_FAIL 30113 匹配获取队伍属性失败

# 帧同步服务类错误

错误码 KEY 描述
EC_RELAY_ALREADY_EXISTS 40000 重复创建
EC_RELAY_NOT_EXISTS 40001 服务不存在
EC_RELAY_DATA_EXCEED_LIMITED 40002 data 长度超限制
EC_RELAY_MEMBER_ALREADY_EXISTS 40003 成员已存在
EC_RELAY_MEMBER_NOT_EXISTS 40004 成员不存在
EC_RELAY_STATE_INVALID 40005 状态异常
EC_RELAY_INVALID_FRAME_RATE 40006 帧率非法
EC_RELAY_SET_FRAME_RATE_FORBIDDEN 40007 开局状态下,G 不允许修改帧率
EC_RELAY_NO_MEMBERS 40008 没任何成员
EC_RELAY_GAMESVR_SERVICE_NOT_OPEN 40009 自定义扩展服务(gamesvr)未开通
EC_RELAY_REQ_POD_FAIL 40010 请求分配 pod 失败
EC_RELAY_NO_AVAILABLE_POD 40011 无可用的 pod
EC_RELAY_LOGIC_ERROR 40014 逻辑错误
EC_RELAY_HKV_CACHE_ERROR 40015 共享内存缓存错误
EC_RELAY_REDIS_CACHE_ERROR 40016 redis 缓存错误
EC_RELAY_CACHE_ERROR 40017 缓存错误
EC_RELAY_NOTIFY_RELAYWORKER_FAIL 40018 通知 relayworker 失败
EC_RELAY_RESET_RELAY_ROOM_FAIL 40019 重置房间对局失败
EC_RELAY_CLEAN_RELAY_ROOM_FAIL 40020 清理房间对局数据失败
EC_RELAY_NO_PERMISSION 40100 没权限,401开头是权限相关错误
EC_RELAY_NOTIFY_GAMESVR_FAIL 40200 通知自定义服务 gamesvr 失败, 402开头,是自定义 gamesvr 相关的错误
EC_RELAY_FORWARD_TO_GAMESVR_FAIL 40201 转发到自定义逻辑 svr 失败
EC_RELAY_FORWARD_TO_CLIENT_FAIL 40202 转发到 client-sdk 失败

# 参数错误

错误码 KEY 描述
EC_INVALID_PARAMS 60000 业务参数错误
EC_INVALID_PARAMS_PLAY_MODE_VERSION 60001 玩法协议版本号错误
EC_INVALID_PARAMS_PLAY_MODE_RULETYPE 60002 玩法协议规则类型错误
EC_INVALID_PARAMS_PLAY_MODE_EXPRESSION 60003 玩法协议规则表达式错误
EC_INVALID_PARAMS_PLAY_MODE_TEAM 60004 玩法协议规则团队表达式错误
EC_INVALID_PARAMS_GAME_ID 61000 参数错误 game_id
EC_INVALID_PARAMS_PLAYER_INFO 61001 参数错误 player_info
EC_INVALID_PARAMS_MAX_PLAYERS 61002 参数错误 max_players
EC_INVALID_PARAMS_ROOM_TYPE 61003 参数错误 room_type
EC_INVALID_PARAMS_PLAYER_ID 61004 参数错误 player_id
EC_INVALID_PARAMS_MATCH_TYPE 61005 参数错误 match_type
EC_INVALID_PARAMS_MATCH_CODE 61006 参数错误 match_code
EC_INVALID_PARAMS_OPEN_ID 61007 参数错误 open_id
EC_INVALID_PARAMS_PLATFORM 61008 参数错误 platform
EC_INVALID_PARAMS_TIMESTAMP 61009 参数错误 timestamp
EC_INVALID_PARAMS_SIGN 61010 参数错误 sign
EC_INVALID_PARAMS_NONCE 61011 参数错误 nonce
EC_INVALID_PARAMS_TOKEN 61012 参数错误 token
EC_INVALID_PARAMS_NETWORK_STATE 61013 参数错误 network_state
EC_INVALID_PARAMS_ROOM_NAME 61014 参数错误 room_name
EC_INVALID_PARAMS_CREATE_ROOM_TYPE 61015 参数错误 create_room_type