微端搭好了玩家一直卡更新？PatchList.txt这几个坑我替你踩完了

a6232173

微端搭好了，玩家进去一直卡在更新——PatchList.txt这几个坑我替你踩完了

论坛这两天又有人贴出来了：微端能连上，登录器能打开，就是点更新之后一直卡在那，要么不动，要么下了一半报错，要么音乐文件死活不下载。

这问题我之前整整搞了三天，现在把排查路径整理出来，碰到同样情况的照着查。

先确认一件事：微端更新靠的是PatchList.txt

翎风引擎的微端更新逻辑很简单——登录器启动时读取你服务器上的PatchList.txt，把里面列出来的文件和本地文件做对比，不一样就下载，一样就跳过。

所以一旦更新出问题，90%根源在PatchList.txt的写法上。

坑一：WAV音乐文件不下载

这是最近论坛里提得最多的问题，具体表现是：进游戏没有背景音乐，手动去客户端目录看，Music文件夹里的WAV文件要么没有，要么版本是旧的。

原因是PatchList.txt里的文件路径格式写错了。

翎风微端的路径规则是相对于客户端根目录的，音乐文件要这样写：

2. Music
   .wav|文件大小|MD5值
3. Music.wav|文件大小|MD5值
4. Music\背景音乐1.wav|文件大小|MD5值

复制代码

很多人会写成 /Music/001.wav 或者 Music/001.wav——注意是反斜杠 \ 不是正斜杠 /，否则登录器找不到对应路径，直接跳过这个文件的下载，也不报任何错误。

还有一种情况：音乐文件太大（单个WAV几十MB），默认配置下登录器有单文件大小限制。遇到这种情况可以在LFLogin.ini里找 MaxFileSize 参数把上限调大，或者把WAV压缩成MP3再重新生成PatchList。

坑二：MD5值算错了

PatchList.txt每行格式是：

2. 文件相对路径|文件大小（字节）|MD5值

复制代码

三个字段缺一不可，分隔符是竖线 | 。

MD5值要用工具算，不能手写，不能猜。用Windows自带的certutil命令算：

2. certutil -hashfile Music
   .wav MD5

复制代码

输出类似：

2. MD5 哈希（文件 Music
   .wav）:
3. a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4
4. CertUtil: -hashfile 命令成功完成。

复制代码

复制那串32位的哈希值填进去就行。

最常见的错误：有人会把文件大小填成KB而不是字节，导致大小对不上，登录器每次都重新下载这个文件，又或者因为校验失败跳过不下载。

坑三：服务器上的文件和本地生成PatchList时的文件不一致

这个坑很隐蔽。你在本地把文件准备好，生成了PatchList.txt，然后上传到资源服务器。结果FTP上传的时候，部分文件因为网络问题传了半截，但你不知道。

玩家那边下载下来的文件MD5不对，登录器校验失败，要么死循环下载，要么直接跳过。

排查方法：上传完成后在服务器上用脚本重新验算一遍MD5，和本地生成的PatchList对比，有不一致的重传。

坑四：资源服务器URL末尾有没有斜杠

LFLogin.ini里有一行：

2. PatchURL=http://你的IP:端口/client/

复制代码

注意URL末尾有没有 / ——如果PatchList.txt里的文件路径是 Music
.wav，服务器URL末尾没有斜杠，拼出来就是 http://ip:port/clientMusic
.wav，变成了一个错误地址。

正确写法：URL末尾必须有 /，这样拼出来才是 http://ip:port/client/Music
.wav。

坑五：PatchList.txt编码问题

PatchList.txt必须是ANSI或GBK编码，不能是UTF-8（带BOM或不带BOM都不行）。

如果文件路径里有中文（比如"背景音乐\传奇主题.wav"），用记事本另存为ANSI编码。UTF-8下中文路径会乱码，登录器找不到文件。

自动生成PatchList的推荐方式

翎风官方在引擎包的tools目录里提供了PatchListMaker工具，拖入客户端目录就能自动生成，MD5和文件大小都是自动算的，比手写可靠多了。

快速排查清单

遇到传奇单机版微端更新问题先过这五条：

1. 文件路径用反斜杠 \ 不是正斜杠 /
2. MD5值用certutil重新算一遍，确认和服务器文件一致
3. 文件大小字段是字节数，不是KB
4. PatchURL末尾有 /
5. PatchList.txt编码是ANSI/GBK，不是UTF-8

五条都过了还有问题，打开登录器日志模式（LFLogin.ini里 LogLevel=2），把日志贴出来看报的是哪一步。

有遇到其他微端更新问题的，帖子里说一下，大家一起看。