云游戏存档为什么会丢失?如何实现持久化存储
概要
通过使用对象存储作为持久层并配合启动器脚本同步,解决云游戏串流中的存档丢失问题,保障玩家进度。
你的玩家肝了三个小时,保存了进度,关闭串流,第二天再来时——存档竟然没了。这不是你的游戏代码有 Bug,也不是玩家的操作失误。持有他们存档文件的串流实例被终止并被替换为了一个全新的实例,本地数据的所有字节随之灰飞烟灭。
这就是云游戏串流的根本架构陷阱。像 Amazon GameLift Streams 这样的平台通过使用临时计算资源来优化成本:每个会话都会启动一个新实例,运行你的游戏二进制文件,并在会话结束时将其销毁。这对于资源利用率来说非常棒,但对于任何需要将文件写入磁盘的游戏来说则是灾难。你的存档系统运行完美——游戏完全按设计写入了 %APPDATA%/YourGame/save.dat——但文件系统本身却是临时的。
在这份运维指南中,我将详细介绍究竟是什么坏了、如何检测该问题、如何使用云对象存储构建持久化存档层,以及它的实际运行成本是多少。下面提供的每个脚本都经过生产环境测试,可直接投入到你的项目中使用。
问题所在:临时实例生命周期
以下是典型云游戏串流会话的生命周期以及它发生故障的环节:
- 会话开始 — 平台配置实例,上传你的游戏二进制文件
- 玩家连接 — 游戏启动,玩家开始游玩
- 游戏写入存档 — 存档文件落入本地磁盘(游戏根本不知道这个磁盘是临时的)
- 会话结束 — 玩家断开连接,实例被终止或回收
- 文件被毁 — 所有本地文件被擦除;下一个会话从头开始
最关键的故障点发生在第 4 步到第 5 步之间。你的游戏存档系统正在做它应该做的事情。问题在于其底层的平台将文件系统视为一次性用品。这是一个伪装成游戏玩法 Bug 的基础设施问题,而诸如此类的服务器生命周期问题正是玩家放弃云串流游戏最常见的原因之一。
如何检测此问题
症状非常具体且可复现:
- 玩家反馈:“我的存档总是消失”——但仅限于云游戏/串流用户,本地安装绝不会出现
- 无崩溃日志:游戏运行完美;只是在下次启动时找不到存档
- 会话级持久性:数据在单次会话中存续,但在会话之间消失
- 平台特定:仅影响串流实例,不影响本地或 Dedicated Server 构建
如果你的 Bug 反馈符合这一模式,说明你遇到了临时实例问题。任何游戏端的调试都无法解决它——解决方案存在于基础设施层。
架构设计:将对象存储用作持久层
这个修复方案在概念上很简单:停止依赖实例的本地磁盘进行长期存储。使用持久化对象存储服务(如 Amazon S3)作为权威的存档位置。启动器脚本可以透明地处理同步——你的游戏代码保持不变。
如果你不想自己构建这个存储层,horizOn cloud saves 可以在托管后端中妥善保存玩家的存档数据。
其流程如下:
- 游戏启动前:从 S3 下载现有存档 → 本地文件系统
- 游戏运行期间:监控本地存档文件的变更 → 将更新同步至 S3
- 会话结束时:最终同步确保所有数据在实例销毁前持久化
你的游戏仍然正常写入本地磁盘。它根本不知道启动器正在将这些写入操作镜像到云存储。这种零修改的方法意味着你可以将持久化存档改造到任何现有Game中,而无需触碰一行游戏代码。
第一步:配置 IAM Role
你需要一个 IAM Role,授予串流实例对 S3 bucket 的作用域访问权限。该 Role 必须信任串流服务并遵循最小权限原则。
创建具有以下信任策略的 Role(将 [ACCOUNT_ID] 替换为你的 AWS 账户 ID):
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "gameliftstreams.amazonaws.com"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "[ACCOUNT_ID]"
},
"ArnLike": {
"aws:SourceArn": "arn:aws:gameliftstreams:*:[ACCOUNT_ID]:streamsession/*"
}
}
}
]
}
然后附加一个仅授予所需 S3 操作的内联策略:
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:PutObject",
"s3:GetObject",
"s3:DeleteObject"
],
"Resource": "arn:aws:s3:::your-save-bucket/saves/*"
}
]
}
关键点:将 Resource 限制在特定的前缀,例如 /saves/*——切勿针对整个 bucket。这在 Role 泄露时可以限制爆炸半径,并符合安全最佳实践。根据平台要求,Role 名称必须以 GameLiftStreams- 开头。
第二步:启动器脚本(Windows)
启动器脚本是总指挥。它下载现有存档、启动游戏,并运行后台文件监控器来同步更改。以下是 Windows 批处理版本:
@echo off
setlocal
set SCRIPT_DIR=%~dp0
if not defined LOCAL_SAVE_FILE_PATH (
echo WARNING: LOCAL_SAVE_FILE_PATH not set, skipping save sync
goto :start_app
)
if not defined S3_SAVE_PATH (
echo WARNING: S3_SAVE_PATH not set, skipping save sync
goto :start_app
)
set LOG_FILE=%SCRIPT_DIR%save_sync.log
set REGION_ARG=
if defined AWS_REGION set REGION_ARG=-Region "%AWS_REGION%"
REM Download existing save from S3
powershell -NoProfile -ExecutionPolicy Bypass -File "%SCRIPT_DIR%download-save.ps1" ^
-S3Path "%S3_SAVE_PATH%" -LocalPath "%LOCAL_SAVE_FILE_PATH%" ^
-LogFile "%LOG_FILE%" %REGION_ARG%
REM Start background file watcher
start "" /b powershell -NoProfile -WindowStyle Hidden -ExecutionPolicy Bypass ^
-File "%SCRIPT_DIR%watch-save.ps1" -WatchPath "%LOCAL_SAVE_FILE_PATH%" ^
-S3Path "%S3_SAVE_PATH%" -LogFile "%LOG_FILE%" %REGION_ARG%
:start_app
REM Replace with your actual game executable:
YourGame.exe -f
这两个环境变量(S3_SAVE_PATH 和 LOCAL_SAVE_FILE_PATH)是通过你的后端服务在调用 StartStreamSession 时传递的。S3 路径对每个玩家必须是唯一的——通过经过身份验证的玩家 ID 构建它,例如 s3://your-bucket/saves/{player-id}/save.dat。切勿使用会话 ID;会话 ID 在不同会话之间会改变,这会导致存档数据成为孤儿。
第三步:下载脚本
这个 PowerShell 脚本检查 S3 中是否存在现有的存档文件,如果找到则下载:
param(
[Parameter(Mandatory=$true)][string]$S3Path,
[Parameter(Mandatory=$true)][string]$LocalPath,
[Parameter(Mandatory=$true)][string]$LogFile,
[Parameter(Mandatory=$false)][string]$Region
)
$timestamp = Get-Date -Format 'yyyy-MM-dd HH:mm:ss'
Add-Content -Path $LogFile -Value "$timestamp - Checking for save at: $S3Path"
$regionArgs = @()
if (-not [string]::IsNullOrWhiteSpace($Region)) {
$regionArgs = @('--region', $Region)
}
# Ensure local directory exists
$localDir = Split-Path $LocalPath -Parent
if (-not (Test-Path $localDir)) {
New-Item -ItemType Directory -Path $localDir -Force | Out-Null
}
try {
$result = & aws s3 cp $S3Path $LocalPath @regionArgs 2>&1
if ($LASTEXITCODE -eq 0) {
Add-Content -Path $LogFile -Value "$(Get-Date -Format 'yyyy-MM-dd HH:mm:ss') - Downloaded save from S3"
} else {
Add-Content -Path $LogFile -Value "$(Get-Date -Format 'yyyy-MM-dd HH:mm:ss') - No existing save found (first session?)"
}
} catch {
Add-Content -Path $LogFile -Value "$(Get-Date -Format 'yyyy-MM-dd HH:mm:ss') - Download error: $_"
}
对于没有现有存档的新玩家,S3 复制将会失败——这是意料之中的。游戏将创建一个新的存档文件,监控器会捕获到它。
第四步:文件监控器
这是在游戏运行期间保持存档同步的组件:
param(
[Parameter(Mandatory=$true)][string]$WatchPath,
[Parameter(Mandatory=$true)][string]$S3Path,
[Parameter(Mandatory=$true)][string]$LogFile,
[Parameter(Mandatory=$false)][string]$Region
)
$timestamp = Get-Date -Format 'yyyy-MM-dd HH:mm:ss'
Add-Content -Path $LogFile -Value "$timestamp - Watching for changes: $WatchPath"
$regionArgs = @()
if (-not [string]::IsNullOrWhiteSpace($Region)) {
$regionArgs = @('--region', $Region)
}
$folder = Split-Path $WatchPath -Parent
$fileName = Split-Path $WatchPath -Leaf
if (-not (Test-Path $folder)) {
New-Item -ItemType Directory -Path $folder -Force | Out-Null
}
try {
$watcher = New-Object System.IO.FileSystemWatcher
$watcher.Path = $folder
$watcher.Filter = $fileName
$watcher.NotifyFilter = [System.IO.NotifyFilters]::LastWrite -bor `
[System.IO.NotifyFilters]::Size
$watcher.EnableRaisingEvents = $true
while ($true) {
$change = $watcher.WaitForChanged(
[System.IO.WatcherChangeTypes]::All, 1000
)
if (-not $change.TimedOut) {
$ts = Get-Date -Format 'yyyy-MM-dd HH:mm:ss'
Add-Content -Path $LogFile -Value "$ts - Change detected: $($change.ChangeType)"
try {
$s3Result = & aws s3 cp $WatchPath $S3Path @regionArgs 2>&1
if ($LASTEXITCODE -eq 0) {
Add-Content -Path $LogFile -Value "$(Get-Date -Format 'yyyy-MM-dd HH:mm:ss') - Synced to S3"
} else {
Add-Content -Path $LogFile -Value "$(Get-Date -Format 'yyyy-MM-dd HH:mm:ss') - Sync failed: $s3Result"
}
} catch {
Add-Content -Path $LogFile -Value "$(Get-Date -Format 'yyyy-MM-dd HH:mm:ss') - Sync error: $_"
}
}
}
} catch {
Add-Content -Path $LogFile -Value "$(Get-Date -Format 'yyyy-MM-dd HH:mm:ss') - Watcher crashed: $_"
}
第五步:Linux/Proton 变体
对于基于 Linux 的串流实例,请将 PowerShell 监控器替换为 inotifywait:
#!/bin/bash
# watch-save.sh — Linux equivalent using inotify-tools
WATCH_PATH="$1"
S3_PATH="$2"
LOG_FILE="$3"
echo "$(date -Iseconds) - Watching: $WATCH_PATH" >> "$LOG_FILE"
while true; do
inotifywait -e modify -e create "$WATCH_PATH" 2>/dev/null
sleep 2 # Brief debounce
aws s3 cp "$WATCH_PATH" "$S3_PATH" 2>/dev/null
if [ $? -eq 0 ]; then
echo "$(date -Iseconds) - Synced to S3" >> "$LOG_FILE"
else
echo "$(date -Iseconds) - Sync failed" >> "$LOG_FILE"
fi
done
成本分析:真实数字
让我们量化一下这个架构的实际运行成本:
S3 PUT 请求(写入操作)
如果你的游戏在游玩期间每 30 秒自动保存一次,一个典型的 2 小时会话会产生大约 240 次 PUT 请求。按 S3 每 1,000 次请求 0.005 美元的定价计算:
- 每个会话成本:$0.0012
- 每月 10,000 个玩家会话成本:$1.20
S3 GET 请求(读取操作)
每次会话开始时进行一次 GET 请求以下载现有存档:
- 每 10,000 个会话成本:$0.40
S3 存储
平均存档文件:每个玩家 5 MB。对于 10,000 名月活跃玩家:
- 总存储量:约 50 GB
- 按 $0.023/GB 计算的月成本:$1.15
10,000 MAU 的每月总成本
低于 3 美元/月。 与计算成本相比,这微不足道。在独立游戏规模下,S3 层基本上是免费的。
生产环境优化:去抖动同步(Debounced Syncing)
原始文件监控器会在每次写入时触发。频繁自动保存的游戏(每 10-15 秒一次)将产生过多的 PUT 请求。添加去抖动延迟——在最后一次更改后等待 5 秒再进行同步:
# Debounce logic — add to the change handler in watch-save.ps1
$lastSync = [DateTime]::MinValue
$debounceSeconds = 5
# Inside the WaitForChanged loop, replace the sync block:
if (-not $change.TimedOut) {
$now = Get-Date
if (($now - $lastSync).TotalSeconds -ge $debounceSeconds) {
& aws s3 cp $WatchPath $S3Path @regionArgs 2>&1
$lastSync = $now
}
}
这可以将 PUT 请求减少 60-80%,同时将数据丢失风险降到最低。即使实例在去抖动期间终止,最多也只会丢失 5 秒的进度——对于大多数游戏而言这是完全可以接受的。
边缘情况与故障模式
存档文件尚不存在(新玩家)
下载步骤会失败——这是正确的行为。游戏会创建一个新的存档,文件监控器会在第一次写入时捕获它。无需特殊处理。
网络中断导致的上传损坏
如果在 PUT 请求期间网络中断,S3 对象可能会不完整。可以通过在上传后验证 ETag 来缓解此问题:
# After syncing, verify upload integrity
$localHash = (Get-FileHash -Path $WatchPath -Algorithm MD5).Hash.ToLower()
$s3Head = & aws s3api head-object --bucket your-bucket --key saves/player123/save.dat 2>&1
$s3ETag = ($s3Head | ConvertFrom-Json).ETag.Trim('"')
if ($localHash -ne $s3ETag) {
Add-Content -Path $LogFile -Value "$(Get-Date -Format 'yyyy-MM-dd HH:mm:ss') - INTEGRITY MISMATCH - re-uploading"
& aws s3 cp $WatchPath $S3Path @regionArgs 2>&1
}
多个存档槽
如果你的游戏支持多个存档文件,请监控目录而不是单个文件。将 $watcher.Filter 设置为 * 并同步整个存档目录。对于大量文件,在上传前压缩为单个 .zip 文件。
存档文件大小限制
S3 支持最大 5 TB 的对象,因此文件大小不是实际需要担忧的问题。大多数游戏存档都在 500 KB 到 50 MB 之间。如果你处理的是包含海量状态(>500 MB)的程序化生成世界,请考虑在上传前使用 gzip 进行压缩——典型的存档数据可以压缩到原始大小的 20-40%。
玩家在多台设备上游玩
如果玩家在同一天从不同设备进行串流,最后一次会话的存档会覆盖前一个存档。对于大多数单人游戏而言,这是正确的行为。对于需要合并语义的游戏(例如云同步的物品栏),你需要冲突解决逻辑——这也是为什么专属后端服务会变得至关重要。
最佳实践
将 IAM Role 限制在特定的 S3 前缀 — 使用
arn:aws:s3:::your-bucket/saves/*而不是整个 bucket 的权限。这遵循了最小权限原则,并在凭证泄露时限制了损害。Role 名称必须以GameLiftStreams-开头以满足平台要求。从经过身份验证的身份构建每个玩家的 S3 Key — 使用
saves/{platform-user-id}/save.dat,绝不要使用saves/{session-id}/save.dat。会话 ID 在会话之间会改变,这会导致存档数据永久变成孤儿。在生产环境中实现去抖动同步 — 原始文件系统监控器会在每次保存时生成一个 PUT 请求。5 秒的去抖动窗口可以将 API 调用减少 60-80%,同时将数据丢失风险保持在一个自动保存间隔之内。
记录每个同步操作 — 存档失败对玩家来说是不可见的,直到他们丢失了几个小时的进度。上述脚本中的
$LogFile模式为你提供了实例上的持久审计跟踪。将这些日志发送到你的监控系统以便主动发出警报。使用实例终止进行测试,而不仅仅是断开连接 — 在游戏进行到一半时杀死串流实例,以验证你的去抖动同步窗口是否可接受。优雅的断开连接会留出完成最终同步的时间;而突然终止则不会。
BaaS 捷径:为什么自己构建可能得不偿失
上述架构确实有效——它经过了实战检验且运行成本几乎为零。但它需要你管理 IAM Role、启动器脚本、文件监控器、完整性检查、Linux 变体以及多环境配置。对于小团队来说,这需要花费 2-4 天的基础设施工作,而这些工作与你的实际游戏毫无关系。
horizOn 提供了作为托管服务的云存档功能。你的游戏通过 Unity、Godot、Unreal SDK 或 REST API 将存档数据和进度写入后端,因此没有任何东西依赖于串流实例的磁盘。你无需自己编写任何存储代码,并且每个账户都拥有带有每日备份的专属数据库。
总结
云串流中的持久化游戏存档需要将实例文件系统视为临时的,并使用持久化对象存储作为真实数据源。完整架构包括:
- IAM Role 授予串流实例限定范围的 S3 读/写访问权限
- 启动器脚本 在游戏启动前下载现有存档
- 后台文件监控器 在游戏运行期间通过去抖动写入将更改同步到 S3
- 后端服务 从经过身份验证的玩家身份构建每个玩家的 S3 路径
- 完整性检查 在每次同步时验证上传/下载的正确性
在独立游戏规模下,10,000 名活跃玩家的月成本低于 3 美元。如果你自己构建,实现需要 1-2 天,或者你可以让 horizOn cloud saves 接管存储层。
无论哪种方式,千万不要在不解决此问题的情况下发布云串流游戏。你的玩家不会告诉你他们的存档正在消失——他们只会停止游玩。
Source: Adding persistent game saves to Amazon GameLift Streams