传奇单机架设登录器列表读取失败常见诱因与逐项排查处理办法

单机架设的时候经常碰到登录器打开直接提示列表读取失败，很多人分不清列表读取失败和进游戏连接失败的区别，列表读取失败代表登录器本身拿不到区服文本内容，账号登录网关还没有参与通信，优先从列表地址、文件编码、网关状态、登录器配置几个方向排查，不要直接去修改游戏端口和M2参数。
首先区分两种登录器读取模式，一类是本地txt本地读取模式，一类是http网页读取模式。单机测试优先选用本地列表模式，在登录器配置器里面勾选本地列表，填入本地txt文件完整路径，不要填写网页地址。选用http模式的单机环境，需要启动简易网页服务，把列表txt放到网站根目录，地址填写[http://127.0.0.1/](http://127.0.0.1/)文件名.txt，地址里面不能多出空格，文件名大小写也要和实际文件保持一致，很多人地址末尾多打空格或者txt写成TXT，直接读取失败。
列表文本编码是高频出错点，新建的文本文档默认保存编码如果是UTF8，大部分登录器无法正常解析，打开列表txt，点击另存为，编码选择ANSI，保存之后再测试。列表内部格式也有严格规范，不同引擎配套登录器的分行格式、分隔符不一样，不要直接复制别的版本列表内容，对照引擎自带的示例模板填写，多余空行、特殊符号、中文全角符号都会导致解析中断，出现读取失败。单机列表IP统一填写127.0.0.1，区服名称、登录端口按照网关参数填写，一行代表一个区服。
核对列表网关程序是否正常启动，部分引擎单独带有列表网关，不是依靠登录网关承载列表服务。打开服务端启动批处理，确认列表网关黑色窗口正常停留，没有一闪关闭，查看网关日志，确认监听端口绑定成功。端口被占用是常见情况，电脑其他程序占用列表网关端口，网关看似打开实际没有监听，日志里面会出现端口绑定失败，更换空闲端口之后修改登录器配置里的列表地址端口，重启整套服务端。
安全防护程序拦截也是很普遍的情况，防火墙、防护软件会拦截登录器访问本地文件或者本地网页端口，把登录器程序、列表网关加入放行名单，或者暂时退出防护软件再打开登录器测试。系统自带防火墙会拦截本机回环访问，部分系统默认阻止程序访问127.0.0.1本地端口，关闭防火墙测试，确认是否是拦截导致。
登录器和引擎版本不匹配也会出现列表读取异常，老版本登录器配置器不兼容新版引擎，或者使用了其他引擎的登录器模板。GOM、GEE、BLUE各个引擎登录器互不通用，拿别的引擎登录器读取当前版本列表，大概率读取失败。登录器配置器内还有密钥校验，列表网关密钥和登录器配置里面的密钥字符必须完全一致，密钥不一致时，就算地址文件全部正确，登录器也拿不到列表数据。
文件路径不能带有中文，列表txt、服务端、客户端、登录器配置器存放路径里面全部不能包含中文文件夹名称，中文路径会造成部分组件读取文件异常，直接返回读取失败。不要把列表文件放在桌面或者新建文件夹这类中文目录，移动到磁盘根目录英文文件夹内。
还有一类容易忽略的设置，登录器配置面板里面勾选了微端模式，但是单机环境没有部署微端服务，部分登录器开启微端之后会强制走远程列表通道，本地列表失效，取消微端勾选，切换到普通模式，重新生成登录器再测试。生成登录器之后不要直接复制旧登录器文件，每次修改列表地址、密钥、模式，都要在配置器里面重新生成新的登录器程序，旧登录器会缓存之前的列表地址，修改配置不重新打包不会生效。
排查顺序遵循由简到繁，先用浏览器打开填写的列表地址，如果是http模式，浏览器打不开txt，说明网页服务或者文件路径出错；浏览器可以正常打开文本，登录器依旧读取失败，问题集中在登录器密钥、登录器版本、编码、防火墙拦截。本地txt模式直接双击打开列表确认内容不乱码，另存ANSI编码之后，核对配置器内路径完全一致。
处理完成之后关闭登录器、列表网关、所有服务进程，重新启动服务端，等待列表网关监听成功，再打开新生成的登录器查看列表。排查的时候不要同时改动多个参数，每修改一项单独测试，方便定位问题根源，避免多项错误叠加，长时间找不到列表读取失败的真实原因。