传奇单机列表读取失败排查步骤 单机架设各类常见故障整理汇总

列表读取失败是本地单机搭建过程中最高发的报错，弹出这个提示，优先从登录网关状态、列表文本、登录器配置、端口占用几个方向依次排查，单机环境统一使用127.0.0.1，无需填写外网地址。

登录网关未启动或被拦截，是出现列表读取失败最主要的诱因。启动整套服务端要遵守固定顺序，先启动数据库服务，等待加载完成，再开启登录网关，最后启动M2游戏主程序。很多新手直接打开M2，跳过登录网关，登录器请求读取列表时没有程序响应，直接提示读取失败。打开网关窗口查看日志，红色提示代表网关加载异常。电脑系统防火墙、防护软件会拦截网关进程，部分核心文件会被直接隔离，到防护软件隔离区恢复文件，将整个Mirserver目录添加信任，运行服务端期间关闭实时防护功能。端口被其他软件占用也会造成网关监听失效，使用系统端口查看工具确认端口占用情况，端口冲突就进入游戏控制器配置向导更换闲置端口，保存设置之后重启全部服务。

登录器与列表文本配置错误，也是高频诱因。单机模式选用本地列表，列表txt文件放置在登录器同目录，文本格式有严格规范，多余空行、空格、特殊符号都会导致识别异常。保存列表文件时，选择另存为，编码修改为ANSI，UTF8编码会出现乱码，登录器无法解析区服信息。列表里面填写的IP和端口，要和游戏控制器配置向导内的端口完全匹配，单机环境IP全部填写127.0.0.1，端口数字不能有输入错误。GOM引擎配置登录器，单机测试不要勾选防劫持校验选项，开启后容易触发列表校验失败。登录器工具和M2引擎版本不配套，编译时间差距过大，会出现识别异常，必须使用版本自带配套的登录器配置工具。部分引擎存在密钥校验，登录器填写的密钥和登录网关内密钥不一致，同样触发列表读取失败，打开登录网关复制识别密钥，粘贴到登录器配置面板，重新编译生成登录器，放入客户端目录测试。

文件存放路径以及压缩包损坏带来的问题，也会造成该故障。Mirserver文件夹解压放置在D盘根目录，路径不能包含中文、括号、空格，文件夹层级过多会导致程序读取文件异常。列表文本不要放置在多层子文件夹，目录太深登录器无法定位文件。解压服务端压缩包前关闭防护软件，解压过程文件容易被隔离丢失，原有服务端全部删除，重新解压完整压缩包，修复缺失文件。

完整排查顺序，先确认登录网关正常启动，控制台无红色报错。打开列表txt，核对IP、端口，修改文本编码，清理多余空行。关闭防火墙与防护程序，确认网关文件没有被隔离。核对登录器、引擎版本，同步两边密钥信息。修改完成关闭所有控制台窗口，按照顺序重新启动整套服务，打开登录器测试读取列表。

除列表读取失败外，单机架设还有大量容易碰到的故障。引擎启动闪退，一般是目录带有中文、DBC数据库配置出错，或是程序文件被防护软件删除，将服务端移动到D盘根目录，检查HeroDB路径，恢复隔离文件。数据库加载失败，打开BDE管理员核对HeroDB路径指向D:\Mirserver\Mud2\DB，DBC2000安装出错可以卸载重装，重启电脑让配置生效。进入游戏黑屏，代表补丁没有完整覆盖客户端，把版本包内data、map文件夹复制替换客户端目录，素材缺失会造成地图、装备不显示。创建角色失败，打开DBServer设置面板勾选允许新建人物，数据库索引损坏需要替换原版数据库文件。NPC不触发对话，查看NPC脚本编码与存放路径，脚本丢失或者语法错误，M2控制台会输出报错信息，对照日志定位出错文件。怪物不刷新，检查地图刷新脚本，核对地图编号与坐标，修改刷新文件之后重启游戏服务。登录成功点击开始游戏不开门，优先核对游戏网关端口，查看M2是否正常加载地图资源，出生地图文件缺失就卡在开门界面。人物属性异常，修改数据库字段前做好备份，随意改动字段类型会造成存档损坏。

任何修改操作之前，复制完整Mirserver文件夹备份，配置出错时可以直接还原。每次启动游戏，所有控制台窗口都需要保持打开，关闭窗口服务直接终止。修改配置文件之后，关闭整套服务重新依次启动，改动内容才会生效。新手搭建单机，优先使用简单版本练习，熟悉网关、登录器、数据库之间的联动逻辑，出现报错优先查看M2和网关控制台日志，日志会标注出错文件，方便快速定位故障根源。