微端不自动更新的常见原因
微端服务器未启动或端口不通
微端程序（UpdateServer.exe/MirUpdateGate.exe）必须在服务端先运行并监听指定端口（通常TCP 8000或8888）。若只开了GameCenter没开微端服务，客户端连不上更新源就不会下载。检查服务器防火墙是否放行微端端口，云服务器还需在安全组放行。
登录器微端地址配置错误
用引擎登录器配置器生成登录器时，"允许使用微端模式"未勾选，或微端更新地址填错（应为 http://公网IP:端口 或 http://域名:端口 ，本机测试可用 http://127.0.0.1:8000 ）。地址末尾带多余斜杠或填成游戏网关7000端口也会导致失败。
PAK密码不匹配或补丁版本号不对
微端靠Version.dat或PatchList.txt记录补丁版本号，服务端资源目录下的版本号低于或等于客户端已缓存版本时会判定无需更新停走。PAK格式补丁若PakKey（密码）与客户端LoginGate或M2中设定不一致，微端能下载但解压后地图黑屏花屏，表现为"更新完还是花"。确认PAK密码文件和补丁来自同一版本包。
客户端根目录残留旧缓存或登录器版本冲突
老版本微端登录器会在Data\UpdateCache或Mir3x\Screenshot等目录写本地版本标记，换新服务端后旧标记让微端以为已是最新而跳过。删掉客户端根目录下UpdateCache文件夹和version.ini再重启登录器可强制重检。
网络被拦截（杀毒/代理/校园网）
部分杀软把微端下载进程当可疑行为阻断，关杀软添加信任或换裸连网络测试。公司或校园网封8000等非标准Web端口也会卡在0%。
逐步排查与修复步骤
1. 服务端确认微端程序UpdateServer和MirUpdateGate已启动，浏览器访问 http://你的IP:8000 看是否有响应（部分返回OK即正常）。
2. 打开登录器配置器→勾选允许微端→微端更新地址严格填 http://公网IP:端口（无多余符号）→重新生成登录器放入客户端根目录。
3. 关闭客户端，删除客户端目录下 UpdateCache 文件夹和 version.dat/version.ini（有的叫LoginVer.cfg），再启登录器进游戏观察微端进度条。
4. 若进度条走到100%但地图/NPC仍花屏，核对PAK密码文件 PakKey.txt 是否与补丁包匹配，或重新覆盖完整Wzl/Wil/Pak补丁到微端资源目录。
5. 仍不更新可临时把微端资源目录整个复制到客户端根目录手动覆盖验证是否是网络连通问题。
GOM/GEE引擎微端版和996引擎微端操作逻辑一样，区别仅在微端程序命名和默认端口（996常用8088作微端端口），按上述思路逐一核对即可解决绝大多数不自动更新问题。
