架构决策表：GOG Galaxy HTTP ETag 同步与本地文件状态冲突
GOG Galaxy 采用标准 HTTP 实体标签（ETag 标头，基于 MD5/SHA 哈希）来比对本地存档目录与云端存储桶（S3 Bucket）的一致性。当弱网中断上传或多台设备本地元数据不同步时，客户端会报出“ETag 校验不匹配”或“云同步失败”错误。
| 云同步故障状态 | 底层技术诱因 | 诊断日志关键报错 | 推荐处置方案 |
|---|---|---|---|
| ETag 校验死循环 | 远端 ETag 哈希与本地快照清单不一致 | GalaxyClient.log 报“HTTP 412 Precondition Failed” | 临时关闭云同步，本地覆写后重新上传生成新 ETag |
| 同步后进度遭倒退覆盖 | 远端服务器时间戳异常，误将老存档判为最新 | 本地最新存档文件被几周前的云端旧档覆盖 | 立即在游戏本地根目录与 Windows 卷影副本中抢救原件 |
| 同步服务初始化失败 | GOG 本地 SQLite 数据库 storage.db 损坏 | 客户端无法读取任何本地已安装游戏的同步索引 | 重建 Galaxy 本地数据库，清理损坏的缓存 |
| 无网状态下游戏无法启动 | Galaxy 启动锁未被干净释放 | 双击后卡在后台凭证自检，无界面弹出 | 绕过启动器，直接运行游戏安装根目录的 .exe 原生程序 |
| 离线分包安装包损坏报错 | 多分卷 .bin 文件在下载时发生微小位翻转 | 安装程序运行中途报错“Source file corrupted” | 使用 GOG 提供的校验清单核对每一个分卷的 MD5 |
解决 HTTP 412 ETag 冲突实操流程
当 GOG Galaxy 无法自动协调本地与云端存档版本时：
- 彻底退出 GOG Galaxy 客户端。
- 找到该游戏在本地的真实存档路径（通常位于
%USERPROFILE%\Saved Games、%APPDATA%\Local或%USERPROFILE%\Documents）。 - 首要步骤：将整个存档文件夹完整复制一份到桌面作为安全备份。
- 打开 GOG Galaxy 的客户端日志确认冲突的内部 GameID：
全局搜索%PROGRAMDATA%\GOG.com\Galaxy\logs\GalaxyClient.logCloudStorage与Precondition Failed，确认报错上下文。 - 重新启动 GOG Galaxy -> 右键目标游戏 -> 管理安装 -> 配置 (Configure)。
- 取消勾选 使用 GOG GALAXY 云同步游戏进度，点击“确定”。
- 启动游戏进入主菜单，加载并手动存一个新档，让本地文件修改时间戳更新，然后正常退出游戏。
- 重新进入游戏设置，勾选开启云同步。客户端会弹出“发现本地与云端冲突”的仲裁窗口。选择 使用本地文件，强制向云端提交并刷新服务器端的 ETag 标头。
手动重置损坏的 Galaxy 本地数据库
// 用于强制终止 GOG 进程并重置损坏的本地存储数据库的 PowerShell 脚本
$GalaxyData = "$env:PROGRAMDATA\GOG.com\Galaxy"
if (Test-Path $GalaxyData) {
Get-Process -Name "GalaxyClient", "GalaxyClientService" -ErrorAction SilentlyContinue | Stop-Process -Force
// 清理损坏的网页缓存与本地 SQLite 数据库文件
Remove-Item -Path "$GalaxyData\webcache" -Recurse -Force -ErrorAction SilentlyContinue
Remove-Item -Path "$GalaxyData\storage\galaxy-2.0.db*" -Force -ErrorAction SilentlyContinue
Write-Host "已清理 GOG Galaxy 本地 SQLite 数据库与同步索引缓存。" -ForegroundColor Green
}
无 DRM 离线安装包冷备份准则
GOG 平台的核心价值在于完全剥离 DRM 的原生离线安装包。要实现数字资产永久保存：
- 在电脑浏览器登录 GOG 官方网站：
https://www.gog.com/account。 - 点击目标游戏，展开 下载离线备份安装程序。
- 务必将全部文件完整下载至同一本地文件夹（包含主引导程序
setup_game_1.0.exe及全部依赖分卷setup_game_1.0-1.bin、setup_game_1.0-2.bin等）。 - 校验所有分卷文件的 SHA-256 或 MD5，然后将其归档至 NAS 或离线冷存储硬盘，即使 GOG 服务器未来停机，该安装包依然可在任意离线电脑上无限制部署。