DevilutionX 单机存档在传送时丢失问题的技术分析

问题现象

在DevilutionX 1.5.3版本中，Windows平台用户报告了一个严重的存档丢失问题。当玩家在游戏中进行地牢层级传送操作时，有时会遇到整个角色存档被清空的情况，系统提示"unable to open save file archive"错误。检查损坏的存档文件发现，其中仅保留了一个临时层级文件(templ13)，而其他所有角色数据都已丢失。

技术背景

DevilutionX是经典游戏《暗黑破坏神》的开源重制版，使用MPQ格式存储游戏存档。当玩家在地牢不同层级间传送时，游戏会执行以下关键操作：

1. 调用pfile_save_level()函数保存当前层级的临时状态
2. 该函数通过GetSaveWriter()获取存档写入器
3. 使用SaveLevel()将当前层级数据写入临时文件

根本原因分析

经过深入代码审查，发现问题出在MPQ文件写入机制上。当系统检查文件是否存在时(FileExists())，内部调用Windows API PathFileExistsW()。如果此调用返回错误(非预期的错误代码)，系统会错误地认为文件不存在，转而以"wb"模式(二进制写入)而非"r+b"模式(读写)打开存档文件。

这种错误的打开方式会导致：

1. 现有存档内容被完全清空
2. 只有当前层级的临时数据(templ13)被写入
3. 角色主存档数据永久丢失

特别值得注意的是，当用户使用OneDrive等云同步服务时，文件存在性检查可能因网络延迟或同步冲突而失败，增加了此问题发生的概率。

解决方案

开发团队通过以下改进解决了该问题：

1. 修改文件存在性检查逻辑，不再仅依赖PathFileExistsW()的返回结果
2. 实现更健壮的文件打开策略：
   • 首先尝试以读写模式("r+b")打开现有文件
   • 仅在确实不存在时才使用写入模式("wb")
3. 增加错误处理机制，确保在文件访问异常时不会破坏现有存档

技术启示

这个案例为我们提供了几个重要的技术经验：

1. 文件操作特别是存档操作需要极其谨慎的错误处理
2. 云同步服务可能引入额外的文件系统行为不确定性
3. 关键数据写入应采用"先安全保存，再替换"的策略
4. 文件存在性检查不应仅依赖单一API调用

用户建议

对于普通玩家，建议：

1. 定期手动备份存档文件
2. 避免在云同步文件夹中直接存放游戏存档
3. 保持游戏版本更新以获取稳定性修复

对于开发者，这个案例展示了即使在看似简单的文件操作中，也需要考虑各种边界条件和异常情况，特别是在跨平台和云环境日益普及的今天。