游戏引擎 / 系统课时
处理崩溃和版本回归
处理崩溃和版本回归
新版本开始崩溃或明显变慢时,先确认哪个构建首次失败,再缩小差异,不能随意回退所有设置。本课用产物清单比较建立调查入口,再结合源码分段与存档兼容,形成能再次验收的修复或恢复版本。
学习目标
- 能区分脚本错误、崩溃和系统终止
- 能对比新旧构建并缩小回归范围
- 能制定符合版本与数据约束的恢复方案
确认失败类型与版本范围
收集设备、系统、渠道、构建哈希和复现路线,区分启动失败、脚本错误、原生崩溃与系统因资源压力终止。仅有最后一条日志不能证明崩溃原因;需要对应调用栈、系统记录或可复现的进程行为,证据缺项明确保留。
在同一设备、初始数据和条件下比较上一已知通过构建与新构建。旧版也失败时,不直接称版本回归;可能是系统、数据、服务或环境变化。确认首次出现问题的范围后,再检查源码、资源、预设、引擎与插件版本差异。
保存原有玩家数据或测试样本,新旧版本分别用复制的数据测试。新版已经迁移的数据未必能被旧版读取,直接切回旧包可能制造另一个问题。每一轮试验记录数据格式与初始化条件,不能让测试自身不断改变输入。
对比归档产物的差异
以下完整 PowerShell 7 入口比较两份哈希清单,格式为数组,每项含 path 与 sha256。保存为 compare-release.ps1,用 -OldManifest 与 -NewManifest 指定上一课流程生成的清单;差异只提供候选,不自动判断根因。
param(
[Parameter(Mandatory)][string]$OldManifest,
[Parameter(Mandatory)][string]$NewManifest
)
$ErrorActionPreference = 'Stop'
$oldRows = @(Get-Content -Raw -Encoding UTF8 -LiteralPath $OldManifest | ConvertFrom-Json)
$newRows = @(Get-Content -Raw -Encoding UTF8 -LiteralPath $NewManifest | ConvertFrom-Json)
$oldMap = [Collections.Generic.Dictionary[string,string]]::new([StringComparer]::Ordinal)
$newMap = [Collections.Generic.Dictionary[string,string]]::new([StringComparer]::Ordinal)
# 精确区分大小写路径;重复路径使清单不可信,应先修复输入。
foreach ($row in $oldRows) {
if (-not $row.path -or -not $row.sha256 -or $oldMap.ContainsKey($row.path)) { throw 'Invalid old manifest' }
$oldMap[$row.path] = $row.sha256
}
foreach ($row in $newRows) {
if (-not $row.path -or -not $row.sha256 -or $newMap.ContainsKey($row.path)) { throw 'Invalid new manifest' }
$newMap[$row.path] = $row.sha256
}
$added = 0
$changed = 0
$removed = 0
foreach ($name in $newMap.Keys) {
if (-not $oldMap.ContainsKey($name)) { $added++ }
elseif ($oldMap[$name] -ne $newMap[$name]) { $changed++ }
}
foreach ($name in $oldMap.Keys) {
if (-not $newMap.ContainsKey($name)) { $removed++ }
}
Write-Output ('added={0} changed={1} removed={2}' -f $added, $changed, $removed)预期输出(计数由两份实际清单决定):
added=<COUNT> changed=<COUNT> removed=<COUNT>清单中 PCK 改变只说明整个包的数据字节改变,不告诉你是哪项场景造成崩溃。需要继续结合源码提交与构建记录。二进制哈希不同也可能来自版本字段或构建过程,不能将所有差异直接标成故障。
用分段比较缩小变更
在隔离工作副本中选择已知通过与失败之间的中间提交,用相同工具链和测试条件构建。能稳定复现时可二分缩小;不能复现或无法构建的提交记为不确定,不能随便当成通过。资源和外部依赖也需恢复到对应版本。
若只在换引擎或插件后失败,保持游戏输入一致,对比相关工具版本,并查看原生栈与官方变更记录。原生崩溃的符号必须来自相同二进制版本,拿别的版本栈位置推断会误导。没有真实栈时先补证据,不伪造“空指针”根因。
选择修复还是恢复内容
根因明确且修复小,可发布修复构建;风险较大时,可用上一稳定内容制作恢复版本。Android 更新编号仍要遵守递增规则,服务协议与用户数据迁移也需兼容,不能简单建议安装更低编号的旧 APK。
恢复包同样需要资源、身份、设备与性能验收。性能回归用相同路线和窗口比较,检查关闭诊断采集后的发行结果。已知设备失败未解决时,记录发布范围与处置结论,不用另一台设备的成功覆盖问题。
复测原条件并保存证据
修复后重跑玩家原始条件、最小复现与相关关键功能,保留构建哈希、栈或日志和新旧结果。只有日志不再出现而功能没有恢复,不能关闭问题。将首次失败提交、根因和避免复发的检查加入后续发布记录,调查才形成可复查的闭环。
错误与调试工具范围见 Debugging tools,Android恢复编号约束见 Version your app。