主菜单崩溃调查实录:如何定位Fable-2-Recomp内存池AllocFixed根因
主菜单崩溃调查实录:如何定位Fable-2-Recomp内存池AllocFixed根因
Fable-2-Recomp 是一个将 Xbox 360 版《Fable II》重编译到 PC 上运行的开源项目(基于 ReXGlue SDK,把 PPC 机器码在构建时静态编译为 C++)。它提供启动器、图形设置、无锁帧率等功能,玩家可通过 Fable2.Launcher 图形界面配置分辨率并启动游戏。
在 2026-09-05 的一次开发中,项目遇到一个典型难题:
- 现象:
fable2.cmd d3d12和fable2.cmd vulkan(源码构建的运行时)一进主菜单就崩溃,日志显示Unhandled guest access violation: read of guest 0x0000001C; - 迷惑点:D3D12 和 Vulkan 两个后端崩得一模一样,但官方预编译(prebuilt)DLL 却完全正常。
完整调查过程记录在 docs/main_menu_crash_fix.md,本文带你复盘这条从"崩溃日志"到"内存池 AllocFixed 根因"的排查链。🔍
崩溃现场:一次典型的空指针解引用
崩溃堆栈指向游戏自己的内存池管理器:
sub_83231BE8从静态地址读取内存池描述符指针(值合法);- 接着读取该池的"空闲链表头"(偏移
+12),发现是 0(NULL); - 把 NULL 传给
sub_832304E8,其第一条指令lwz r9, 28(r4)在 guest 地址0x1C处触发访问违规。
更蹊跷的是:启动阶段探测同一个字段时它是非空的(0x400018B0)。也就是说,启动之后、到达主菜单之前,有人把内存池状态"洗掉"了。
关键转折:不是 GPU 后端,而是内存行为差异
排查中有一个重要的"排除法"结论:
- D3D12 与 Vulkan 同样崩溃 → 排除图形后端差异;
- 预编译 D3D12 插件正常 → 排除硬件特性差异。
剩下的唯一变量,是本地 SDK 对 xmemory.cpp 中 BaseHeap::AllocFixed 的一处修改(历史补丁见 thirdparty/sdk_allocfixed_patch.patch)。
这个补丁的本意很合理:
"真机上对已保留区间的再次保留(re-reserve)应当是幂等的",于是让重复保留静默成功,不再打印错误。
根因揭秘:游戏会"根据返回码做分支"
事实是——这个假设对 Fable 2 不成立:
| 行为 | 预编译(原版逻辑) | 源码构建(打补丁后) |
|---|---|---|
| 重复保留 3856 个固定区间 | 返回失败 X_STATUS_NO_MEMORY |
返回成功 |
| 游戏分支判断 | 保留原有内存池状态 ✅ | 误以为是"全新分配",重新初始化内存池 ❌ |
| 空闲链表头 | 正常 | 被清空为 NULL → 主菜单崩溃 |
一句话总结:Fable 2 会检查 AllocFixed 的返回值,成功与否决定了它是否重建内存池。 补丁让"本该失败的保留"成功了,游戏便在不该重建池的时机重建了池,空闲链表头变成 NULL,主菜单一帧之内必崩。
验证数据(release build 日志):
| 运行 | 后端 | AllocFixed 行为 | 重复保留错误数 | 结果 |
|---|---|---|---|---|
| fable_2_035 | D3D12 预编译 | 原版(失败) | 3856 | 正常运行 |
| fable_2_001 | D3D12 预编译 | 原版(失败) | 3856 | 运行 13 分钟 |
| fable_2_022 | D3D12 源码 | 打补丁(成功) | 0 | 主菜单崩溃 |
| fable_2_041 | Vulkan 源码 | 打补丁(成功) | 0 | 主菜单崩溃 |
修复方案:恢复原版语义,并加固诊断
修复动作见 thirdparty/sdk_mainmenu_crash_fix.patch,包含两部分:
- 回滚
BaseHeap::AllocFixed:恢复 v0.10.0 原版逻辑——重复保留已保留的页面时,打印错误并返回 false。游戏依赖这种失败来保留池状态。 - 加固崩溃诊断:
exception_handler_win.cpp中原来在处理崩溃时,诊断代码自己又读了未映射的内存表,引发"二次访问违规"、污染崩溃日志。修复后每次读取 guest 内存前先用VirtualQuery(MEM_COMMIT)检查页是否已提交。
修复后 d3d12 与 vulkan 均通过 30 秒定时启动测试,主菜单稳定可见,无 guest AV。✅
给新手的 3 个经验
- 错误日志 ≠ 错误行为:启动时 3856 条
[error] BaseHeap::AllocFixed attempting to reserve an already reserved range现在是预期且无害的——游戏恰恰依赖它们失败。文档明确警告:不要再把它们"修"成成功。 - 跨后端同崩是强信号:两个渲染后端表现一致时,问题大概率不在渲染层,而在共享的内存/系统模拟层。
- 返回值也是行为:模拟器中"更贴近硬件假设"的修改未必正确,游戏代码可能对返回码做了分支,改动返回值等于改变了游戏流程。
延伸阅读
- 完整调查与验证记录:docs/main_menu_crash_fix.md
- 被回滚的 AllocFixed 历史补丁(反面教材):thirdparty/sdk_allocfixed_patch.patch
- 当前正确的 SDK 补丁:thirdparty/sdk_mainmenu_crash_fix.patch
- 项目玩法与功能说明:README.md
- 其他运行时修复笔记:docs/RUNTIME_FIXES.md
