Game

Godot 云存档同步：本地进度、远端版本和冲突选择

讨论 Godot 客户端云存档同步、本地队列、版本号、冲突检测、玩家选择和离线恢复。

Leeting Yan 2025-12-30 10 分钟阅读 4627 字

云存档的难点不是上传文件

Godot 本地存档系统稳定之后，很多项目会加云存档：玩家换设备继续玩，卸载重装不丢进度，桌面和掌机之间同步。技术上，上传和下载一个文件并不复杂。真正难的是冲突：两台设备都玩了，哪个进度算数？离线玩了一小时，云端已有新进度，怎么处理？上传失败后本地状态如何标记？

云存档同步要把本地存档、远端版本、同步队列和玩家选择分开。不能简单地“启动下载覆盖本地，退出上传覆盖云端”。那样迟早会丢玩家进度。

flowchart TD
    A[本地存档] --> B[生成同步摘要]
    C[远端存档元数据] --> D[比较版本]
    B --> D
    D --> E{是否冲突?}
    E -->|否| F[上传或下载]
    E -->|是| G[冲突 UI]
    G --> H[玩家选择本地/云端/保留副本]
    F --> I[更新同步状态]
    H --> I
    I --> J[记录日志和下次同步点]

存档要有同步元数据

云同步需要比较依据。存档里至少要有 profile_id、save_version、updated_at、play_time、device_id、content_version、checksum。只看文件修改时间不够，云端和本地时间可能不准，平台同步也可能改时间。

play_time 和关键进度很有用。两个存档更新时间接近，但一个主线第 5 章，一个第 3 章，玩家更可能想保留第 5 章。冲突 UI 可以展示这些摘要，帮助玩家选择。

checksum 用于确认文件完整性。上传前和下载后都校验，防止损坏文件进入同步流程。损坏存档不应覆盖健康云端。

同步状态要可见

客户端应维护同步状态：已同步、本地有未上传更改、正在上传、上传失败、远端有新版本、冲突待处理。设置页或存档页显示状态，玩家知道自己的进度是否安全。

离线时，本地继续保存，并标记待上传。联网后再同步。不要因为云不可用就阻止单机进度，除非游戏设计强联网。上传失败要保留队列，下一次重试。

自动同步要节制。每次拾取都上传会浪费网络。可以在关键保存点后延迟上传，或退出到主菜单时上传。移动网络下可以尊重玩家设置。

冲突不要静默覆盖

如果本地和云端都在上次同步后发生变化，就存在冲突。不要自动按时间覆盖，除非产品明确接受。更稳的是展示冲突 UI：本地设备、时间、游玩时长、进度摘要；云端设备、时间、游玩时长、进度摘要。玩家选择保留哪份。

还可以提供“保留副本”。选择云端进入游戏前，把本地冲突存档备份为 recovery。玩家后悔时还有找回机会。存档丢失是高敏感问题，多保留一份副本很值。

某些数据可以合并，比如设置和成就标记；某些不能合并，比如剧情分支和背包。不要为了自动化强行合并复杂进度。合并规则要保守。

远端接口和平台差异

云存档可能来自自建后端、Steam Cloud、移动平台云、第三方账号系统。不同平台能力不同。有的平台按文件同步，有的按 key-value，有的只有启动退出时同步。Godot 客户端最好通过 CloudSaveService 抽象。

CloudSaveService 提供上传、下载、列元数据、删除、冲突检查。具体平台 Adapter 处理 API 差异。业务存档系统不直接调用平台 SDK。这样多平台发布时更容易维护。

如果平台自动同步文件，客户端仍要知道同步时机和冲突可能。不要以为平台会替你处理所有用户体验。

隐私和安全

云存档可能包含玩家昵称、进度、设置和本地标识。上传前要遵守隐私政策，不要包含 token 或无关日志。存档可以压缩和加密，但密钥策略要考虑跨设备读取。

联网游戏的关键经济数据仍应服务端权威，云存档只同步客户端进度和设置。不要让玩家通过改本地存档再上传获得非法资产。

调试同步

同步问题很难排查。调试面板显示本地摘要、远端摘要、最后同步时间、队列状态、最近错误、当前设备 ID。测试可以模拟离线、双设备冲突、上传失败、下载损坏。

日志要记录每次同步决策：为什么上传、为什么下载、为什么判定冲突、玩家选择了什么。这样客服处理进度问题时有依据。

小结

Godot 云存档同步的关键是冲突和恢复，而不是上传文件。存档带同步元数据，客户端维护同步状态，离线更改排队，冲突让玩家选择并保留副本，平台差异由 CloudSaveService 封装。云存档的价值是让玩家安心，任何静默覆盖都会破坏这种信任。
我会把云同步测试做成脚本：设备 A 离线玩、设备 B 在线玩、A 恢复网络，然后检查冲突 UI。只测单设备上传下载，看不出云存档真正的风险。

我会把云同步测试做成脚本：设备 A 离线玩、设备 B 在线玩、A 恢复网络，然后检查冲突 UI。只测单设备上传下载，看不出云存档真正的风险。

继续阅读

探索更多技术文章

浏览归档，发现更多关于系统设计、工具链和工程实践的内容。

全部文章返回首页