传奇架设疑难汇总与操作要点 搭建调试容易踩坑事项说明

文件路径是最基础也最容易反复出错的环节，整套服务端存放目录只能使用英文、数字，不要包含中文、空格以及特殊符号，多层目录也会提升读取异常概率。解压文件前关闭防护程序，部分db文件、网关组件、dll库会被直接隔离，解压完成核对文件大小，体积为零代表文件损坏。不要直接在桌面存放整套版本，桌面路径层级复杂，极易引发脚本乱码、数据库读取失败。修改配置、脚本之后，保存格式统一选择无BOM编码，系统自带记事本保存会自带标记，引擎解析时判定语法异常。

数据库相关疑难分为DBC和SQL两类，老式版本使用DBC2000，需要配置ODBC数据源，数据源名称必须和控制器内填写名称完全一致，名称写错会直接提示数据库加载失败。物品、技能库编号不能跳号、重复，空行残留会触发M2启动时报物品数据、魔法数据错误，手动增删装备之后，要及时整理编号序列。SQL类版本常见于手游和新版引擎，导入脚本时留意报错信息，数据表缺失会出现创建角色失败、上线直接卡死。不要随意修改数据库字段结构，跨版本直接导入db或者sql备份，字段数量、定义不一致，引擎启动直接终止。修改数据库内容之后，必须重启整套服务，热加载不会刷新索引结构，表面生效，运行时随机崩溃。

引擎与网关配套问题，不同内核程序不能混用，GOM、GEE、BLUE、白日门、996引擎的网关、登录器、指令集互相不兼容，拿别的版本网关替换之后，会出现识别码校验失败、不开门、连接超时。启动顺序有固定逻辑，先启动数据库，等待监听完成，再依次启动登录网关、角色网关、游戏网关，最后启动M2主程序，部分版本附带微端、公告子服务，需要在引擎之后启动。网关启动之后先查看日志，确认监听成功，再打开登录器测试，网关窗口打开不代表正常监听，端口占用、绑定地址错误会出现假启动。端口需要全程统一，登录网关、角色网关、微端端口，在控制器、登录器、客户端配置三处保持一致，一处漏改就会出现登录正常、加载角色卡住。碰到套接字报错10049、10060，优先检测端口监听状态，再核对地址和拦截策略。

登录器与客户端资源故障，登录器配置器必须和引擎配套，识别码、资源包密码、分区信息填写错误，会出现不开门或者pak校验失败。修改登录器配置之后，一定要重新生成登录程序，旧登录器缓存参数不会自动更新。素材索引错乱会引发装备不显示、斗笠空白、地图黑屏、Range check error范围报错，根源是外观编号超出客户端支持上限，或者导出表记录和pak、wil素材序号不匹配。补丁需要放到客户端对应目录，测试前清理客户端缓存，旧缓存会持续读取失效资源。手游版本和PC端区别很大，修改客户端连接地址之后，不能直接使用，需要重新打包安装包，旧包内置的连接地址不会变更，外网测试时手机要切换流量，不能在同一局域网内判定外网连通性。

脚本调试的疑难点，脚本语法对符号敏感，中文逗号、引号不配对、循环缺少结束标记，都会加载报错。跨引擎复制脚本，指令不兼容，启动阶段不报错，触发NPC、技能、拾取的时候才异常。分段注释法适合长脚本排查，对半屏蔽代码，缩小出错范围，定位到具体行之后再核对参数。Envir目录下的刷怪、NPC、传送配置文件，路径写错、编码异常，会出现地图没有怪物、NPC不显示、传送掉线。外网架设时很多隐藏地址写在传送、脚本、NPC文本里面，只修改网关主配置，传送跳转时读取旧地址，直接掉线，需要全局检索批量替换单机地址。

外网架设的限制和注意事项，单机调试稳定之后再调整外网参数，单机本身存在故障，外网配置只会叠加排查难度。所有用到的端口放行之后，使用端口检测工具验证监听，网络拦截策略、机房端口限制，都会造成端口放行之后依旧不通。部分网络环境无法直接使用公网地址，无论怎么修改配置，外部设备都无法接入。微端是手游外网高频故障点，微端地址、端口和客户端不匹配，客户端无法自动下载补丁，一直卡在资源加载界面。外网调试不要一次性批量修改多项参数，改一处，重启整套服务测试一次，方便定位漏改点位。

系统与权限相关问题，老旧系统组件缺失，Windows2000需要先安装SP4补丁和对应版本运行库，新版运行库无法在老旧系统安装。目录权限不足，引擎无法写入日志、角色存档、行会数据，表现为存档不保存、下线数据丢失。虚拟内存设置过低，长时间运行内存持续上涨，进程随机闪退。不要在服务端内安装过多防护软件，防护程序会持续拦截网关网络访问，造成玩家频繁断连。

日常调试的通用规范，修改任何文件之前备份整套版本，配置改错、数据库损坏时可以直接还原，避免重新解压部署。优先依靠日志排查故障，M2、网关、微端日志会记录加载、连接、脚本报错信息，日志没有收到客户端请求，故障在通讯层面；日志持续读取资源报错，故障在素材和配置。不要跳过报错直接继续测试，很多警告不会立刻关闭引擎，但是会在后续运行中出现隐性异常，比如刷怪失效、爆率不生效、功能随机失效。不要依赖热加载，数据表、pak补丁、大部分脚本修改，热加载不会刷新缓存，测试结果不具备参考意义。

还有一类隐性故障，版本自带插件、授权文件缺失或者不匹配，引擎启动正常，但是部分功能关闭，行会、交易、技能失效。假人、合区、GM工具属于辅助工具，不要在调试阶段同时批量执行修改，大量数据改动叠加之后，很难定位问题来源。合区之前单独备份所有角色、行会、仓库数据表，合区工具参数设置错误，会直接造成数据错乱丢失。