游戏引擎 / 系统课时

分析崩溃与调用栈

分析崩溃与调用栈

遇到 Unreal Engine 5 崩溃时,弹窗里的最后一句错误通常还不足以说明根因。更可靠的做法是先保留 Crash 目录、日志和符号,再从 Call Stack 找到第一个属于项目代码或资源上下文的线索,并用可重复步骤验证修复。

学习目标

  • 能找到一次崩溃对应的日志、Crash Context 与转储文件。
  • 能从调用栈中识别“最先进入项目代码的有效帧”,避免停在引擎表层错误。
  • 能把崩溃信息映射到源码、对象生命周期或蓝图调用,并完成复现与回归验证。

先保存崩溃现场

本地崩溃通常会在项目的 Saved/Crashes 下留下按崩溃实例划分的目录,目录中常见 CrashContext.runtime-xml、日志和 .dmp 转储;具体文件集合会随平台、构建配置和是否启用 Crash Reporter 而不同。排查前先复制整份目录,避免后续运行覆盖线索。

下面的 PowerShell 会找到最近一次本地 Crash 目录,并检查三类关键文件是否存在。将 <PROJECT_DIR> 替换成项目根目录:

powershell
$crashRoot = Join-Path "<PROJECT_DIR>" "Saved/Crashes"
if (-not (Test-Path $crashRoot)) { throw "Crash directory not found: $crashRoot" }

$latest = Get-ChildItem $crashRoot -Directory |
    Sort-Object LastWriteTime -Descending |
    Select-Object -First 1

if (-not $latest) { throw "No crash folders found" }

$context = Get-ChildItem $latest.FullName -Filter "CrashContext.runtime-xml" -File -ErrorAction SilentlyContinue | Select-Object -First 1
$log = Get-ChildItem $latest.FullName -Filter "*.log" -File -ErrorAction SilentlyContinue | Select-Object -First 1
$dmp = Get-ChildItem $latest.FullName -Filter "*.dmp" -File -ErrorAction SilentlyContinue | Select-Object -First 1

[pscustomobject]@{
    CrashDir   = $latest.FullName
    HasContext = [bool]$context
    HasLog     = [bool]$log
    HasDump    = [bool]$dmp
}

预期输出

text
CrashDir   HasContext HasLog HasDump
--------   ---------- ------ -------
<PATH>     <BOOLEAN>  <BOOLEAN> <BOOLEAN>

如果 HasDump 或源码行号缺失,不代表日志无效;但要做精确符号化,必须保存与发生崩溃的可执行文件完全匹配的调试符号。重新编译出的同名 PDB 不能可靠替代原构建产物。

从调用栈找到第一个项目帧

Call Stack 按调用链展示崩溃发生时正在执行的函数。顶部若是内存访问、容器检查或引擎基础函数,只说明“在哪里最终失败”,不一定说明“谁把错误状态传了进来”。真正有价值的起点通常是向下寻找第一个属于自己游戏模块的帧,例如 UnrealEditor-MyGame!ACombatCharacter::TakeDamage()。

读栈时按三个问题推进:

  1. 最顶层错误属于空指针、越界、断言失败,还是 UObject 生命周期相关问题。
  2. 第一个项目帧是哪一个函数、哪个源码文件和行号;如果没有行号,先确认符号是否与构建匹配。
  3. 再向下看一到三层调用者,判断这次调用由输入、Tick、委托、异步回调还是蓝图事件触发。

UE5崩溃从日志到根因的定位流程

把栈帧映射成具体根因

源码帧定位后,不要只看崩溃行本身。比如某行只是调用 CurrentWeapon->Fire(),真正要回答的是 CurrentWeapon 为什么在这里失效:是没有初始化、已经被销毁、网络端不拥有该对象,还是异步回调晚于对象生命周期。

常见定位顺序是“崩溃行 → 当前对象状态 → 上一层调用者 → 最近一次状态写入”。数组越界则反向检查索引来源与容器长度;断言失败先读断言条件,再查谁破坏了这个不变量;如果调用栈主要落在 Blueprint VM 或引擎反射层,就把最近的项目帧、日志里的对象名与可疑蓝图事件放在一起检查,而不是把 VM 函数当成根因。

用同一路径完成回归验证

修复后必须用触发原崩溃的同一关卡、输入顺序、网络角色和数据条件重新测试。能跑一次并不够;如果原问题依赖对象销毁、异步回调或竞态,最好连续执行多轮并观察日志中是否出现新的 ensure、访问无效对象或重复错误。

最终要保留“崩溃构建 + 对应符号 + Crash 目录 + 修复提交”之间的对应关系。这样下一次出现相似调用栈时,可以快速判断是同一根因复发,还是只是表面上落在同一个引擎函数。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

分析崩溃与调用栈

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通