Unciv游戏Android版保存功能异常分析与解决方案

问题背景

Unciv作为一款开源的文明类策略游戏，近期在Android平台上出现了严重的游戏保存功能异常。该问题主要表现为：

1. 游戏无法正常保存进度
2. 玩家结束回合时游戏崩溃退出
3. 自动保存功能失效

技术分析

错误根源

通过分析错误日志，发现问题核心在于文件系统权限处理不当。具体表现为：

java.io.FileNotFoundException: /storage/emulated/0/Android/data/com.unciv.app/files/SaveFiles/Autosave: open failed: ENOENT (No such file or directory)

这表明游戏尝试在未创建的目录路径下进行文件保存操作，导致IO异常。在Android 11(API 30)及更高版本上，由于存储访问框架(SAF)的限制，此类问题更为常见。

深层原因

1. 目录创建逻辑缺失：游戏未在保存前确保目标目录存在
2. 权限处理不足：未正确处理Android的Scoped Storage限制
3. 异常处理不完善：文件操作失败后未提供友好的用户反馈

解决方案

开发团队通过以下方式解决了该问题：

1. 目录预检查机制：在保存操作前，先检查目标目录是否存在，若不存在则自动创建
2. 增强错误处理：添加更完善的异常捕获和处理逻辑
3. 兼容性改进：优化了针对不同Android版本的存储访问策略

技术实现细节

关键代码修改

// 修改后的保存逻辑示例
fun saveGame() {
    try {
        // 确保目录存在
        if(!saveDirectory.exists()) {
            saveDirectory.mkdirs()
        }
        // 执行保存操作
        fileHandle.writeString(saveData)
    } catch (e: Exception) {
        // 增强的错误处理
        logger.error("保存失败", e)
        showErrorToUser("无法保存游戏")
    }
}

兼容性考虑

针对Android不同版本：

• Android 10+：使用Context.getExternalFilesDir()获取应用专属存储
• 旧版本：保持原有存储访问方式
• 添加Manifest权限声明

用户应对方案

遇到类似问题的用户可以：

1. 更新到最新版本的游戏
2. 检查应用存储权限是否开启
3. 手动创建游戏保存目录（高级用户）
4. 如问题持续，清除应用数据后重试

预防措施

为避免类似问题再次发生，开发团队采取了以下措施：

1. 增加存储操作的单元测试
2. 实现更完善的日志系统
3. 建立Android版本兼容性测试矩阵
4. 改进用户反馈机制

总结