封挂功能配置
AC封挂网关日志错误码排查说明
详解 AC 封挂网关 GameProtect 日志中的错误码格式、问题大类和具体错误码含义，帮助 GM 快速定位和排查玩家断开原因。
错误码格式
客户看到的错误码通常类似 6:20000001、0:00000007、5:70000001。
- 冒号前面的数字：问题大类
- 冒号后面的数字：具体原因
错误码不等于一定开挂。它表示客户端、入口、服务端或后台策略发现了异常。判断时建议结合出现频率、是否集中在同一个网吧/IP、是否刚更新版本、是否只有个别玩家出现等因素综合分析。
问题大类
| 大类 | 说明 |
|---|---|
| 0 | 连接或游戏数据异常 |
| 1 | 调试或测试环境异常 |
| 2 | 虚拟或特殊环境异常 |
| 3 | 未知异常 |
| 4 | 时间或速度环境异常 |
| 5 | 入口或验证流程异常 |
| 6 | 客户端安全组件或通信异常 |
| 7 | 后台策略或黑名单处理 |
0 — 连接或游戏数据异常
常见非外挂原因：登录器版本不对、游戏引擎或脚本更新后未同步、入口转发不一致、客户端和服务端版本不配套、网络数据异常。
1 — 调试或测试环境异常
常见非外挂原因：客户正在测试、调试工具未关闭、测试环境残留。
2 — 虚拟或特殊环境异常
常见非外挂原因：玩家使用虚拟机、云电脑、远程桌面、网吧特殊系统环境。
3 — 未知异常
常见非外挂原因：新系统、新环境、新客户端兼容问题。
4 — 时间或速度环境异常
常见非外挂原因：系统时间异常、机器严重卡顿、虚拟机/云电脑计时不准、网络严重延迟、客户端版本不配套。
5 — 入口或验证流程异常
常见非外挂原因：入口 IP/端口/密码配置不一致、玩家走错入口、验证窗口显示异常、网络超时、客户端版本不对。
6 — 客户端安全组件或通信异常
常见非外挂原因：客户端安全组件未加载、被杀毒软件拦截、下载失败、版本不配套、网络不通或被拦截、玩家启动了旧登录器。
7 — 后台策略或黑名单处理
常见非外挂原因：客户 IP、机器码、角色名、账号被后台误加入黑名单，或旧封禁记录未清理。
常见断开错误码
0 类错误
| 错误码 | 现象 | 非外挂可能原因 |
|---|---|---|
| 0:00000000 | 游戏验证流程异常 | M2 脚本版本不对、验证脚本被改、登录器与服务端版本不一致 |
| 0:00000001 | 玩家进入游戏早期数据不符合规则 | 登录器版本不对、游戏引擎数据变动、M2 脚本顺序变化 |
| 0:00000002 | 验证结果状态不匹配 | 验证流程超时后又返回、客户端/服务端版本不一致 |
| 0:00000003 | 验证通过数据出现重复、提前或状态异常 | M2 脚本重复发送、网络延迟导致旧数据迟到 |
| 0:00000004 | 验证取消状态异常 | M2 脚本误发取消、验证状态已经结束 |
| 0:00000005 | 游戏数据操作结果异常 | M2 脚本重复返回、操作已超时 |
| 0:00000006 | 游戏脚本或文本指令异常 | M2 脚本输出格式错误、插件脚本误发 |
| 0:00000007 | 网关无法识别玩家进入游戏的首包 | 入口配置不对、走错网关、登录器版本不对 |
| 0:00000369 | 客户端安全检测长时间无响应 | 安全组件未加载、杀毒软件拦截、DLL 版本不对 |
| 0:10000001 | 前置检查已经失败 | 前置连接或版本检查失败 |
4 类错误
| 错误码 | 现象 | 非外挂可能原因 |
|---|---|---|
| 4:20000009 / 4:20000010 | 客户端时间或速度环境异常 | 机器严重卡顿、虚拟机计时异常、系统时间跳变 |
| 4:20000013 / 4:20000014 / 4:20000015 / 4:20000031 | 客户端安全校验返回异常 | 客户端和服务端版本不配套、旧登录器 |
| 4:70000013 | 客户端状态不符合服务端要求 | 旧登录器、客户端补丁没更新、安全组件没加载 |
5 类错误
| 错误码 | 现象 | 非外挂可能原因 |
|---|---|---|
| 5:70000001 | 入口握手失败 | 入口 IP/端口/密码配置错误、登录器版本旧 |
| 5:50000001 | 游戏验证流程重复触发 | M2 脚本重复触发验证 |
| 5:20000006 / 5:20000008 / 5:20000082 | 图片验证或点击验证异常 | 网络卡、验证窗口未显示、远程桌面影响点击 |
6 类错误
| 错误码 | 现象 | 非外挂可能原因 |
|---|---|---|
| 6:20000000 | 游戏连接长时间无响应 | 玩家断网、网络卡死、客户端崩溃 |
| 6:20000001 | 客户端安全信息没有按时上传 | 安全组件未加载、杀毒软件拦截、云下发失败 |
| 6:20000002~08 | 客户端安全检测超时未返回 | 客户端卡顿、安全组件异常、版本不配套 |
| 6:20000020 | 客户端安全组件加载失败 | 杀毒软件拦截、下载失败、文件权限不足 |
| 6:20000028 / 6:20000050 | 客户端输入相关数据没有按时返回 | 客户端窗口无焦点、系统权限不足 |
| 6:20000029~68 | 客户端周期安全校验异常或超时 | 版本不配套、旧登录器、更新不完整 |
| 6:20000036 | 客户端安全通信协商失败次数过多 | 版本不配套、网络异常、客户端文件损坏 |
| 6:20000060 | 客户端上传了异常消息 | 客户端版本不对、协议更新不一致 |
| 6:20000090~91 / 6:20000100 | 客户端心跳、动态状态或安全确认超时 | 网络延迟、客户端卡死 |
| 6:20000092 / 6:20000095~96 | 游戏数据状态异常 | 服务端脚本/引擎更新后客户端未同步 |
| 6:20000093 | 登录器版本过低 | 玩家没更新登录器、下载站缓存了旧版本 |
| 6:20000666 | 客户端主动上报需要断开 | 客户端环境检测失败、系统兼容问题 |
| 6:40000001~04 | 微信绑定或随机验证失败 | 玩家输入错误、验证超时、微信被后台限制 |
| 6:40000005~06 | 实名验证超时或后台要求断开 | 实名系统返回超时、玩家未完成验证 |
| 6:50000003 | 后台要求强制断开该玩家 | 管理员手动操作、后台规则误命中 |
7 类错误
| 错误码 | 现象 | 非外挂可能原因 |
|---|---|---|
| 7:30000001 | 后台下发断开玩家并提示客户端 | 管理员手动处理、后台策略配置命中 |
| 7:30000002 | 命中后台黑名单或封禁策略 | IP/机器码/账号/角色名被误加黑名单 |
后台记录码
下列 0:20xxxxx 多数是后台风险记录或证据码，不一定会立即断开玩家。适合用于判断客户端是否稳定、版本是否匹配、网络是否正常。
| 记录码 | 现象 |
|---|---|
| 0:349 / 0:350 | 客户端文件环境信息异常 |
| 0:394 | 客户端窗口环境信息超时 |
| 0:2006 / 0:2011 | 客户端输入状态数据上传标记（非错误） |
| 0:20000013~81 | 客户端安全检测异常或超时记录 |
| 0:20000090 / 0:20000103~09 / 0:20000112 | 客户端状态、心跳或环境信息超时 |
| 0:20000117~28 | 客户端环境、在线状态或游戏状态数据异常 |
排查优先级
按以下顺序排查问题：
- 大量玩家同时出现：先查服务端更新、登录器版本、入口配置、云下发地址、网络出口
- 集中在某个网吧或 IP：先查 IP 是否被拉黑、网吧安全软件、防火墙、代理或网络劫持
- 只有单个玩家出现：让玩家更新登录器、关闭杀毒拦截、重新解压客户端、不使用虚拟机/远程桌面
- 同一玩家反复出现 6 类错误：重点查客户端安全组件是否被拦截、无法加载或无法通信
- 出现 7 类错误：优先查后台黑名单、机器码黑名单、角色/账号封禁记录和人工处理记录