2.3 Root 析构与清理顺序
构造有顺序,清理同样有顺序,而且顺序必须与构造相反。OgreRoot.cpp 里 shutdown() 显式调用,~Root() 里则按创建倒序 reset 各管理器。
shutdown():五个关键环节
// OgreMain/src/OgreRoot.cpp:Root::shutdown(v14.6.3 源码摘录,已删减)
void Root::shutdown(void)
{
if(mActiveRenderer)
mActiveRenderer->_setViewport(NULL);
// Since background thread might be access resources,
// ensure shutdown before destroying resource manager.
mWorkQueue->shutdown();
if(mSceneManagerEnum)
mSceneManagerEnum->shutdownAll();
if(mFirstTimePostWindowInit)
{
shutdownPlugins();
mParticleManager->removeAllTemplates(true);
mFirstTimePostWindowInit = false;
}
mSceneManagerEnum.reset();
mShadowTextureManager.reset();
ShadowVolumeExtrudeProgram::shutdown();
ResourceGroupManager::getSingleton().shutdownAll();
// Destroy pools
ConvexBody::_destroyPool();
mIsInitialised = false;
LogManager::getSingleton().logMessage("*-*-* OGRE Shutdown");
}
顺序的每一步都有原因:
mWorkQueue->shutdown()最先——注释直说:「后台线程可能正在访问资源,必须在销毁资源管理器之前停掉它」。后台资源加载线程不先停,后面删资源会踩悬空引用;shutdownAll()场景管理器——场景里挂着可移动对象与渲染队列,先统一关;shutdownPlugins()卸插件——插件可能注册了场景类型、编解码器,后注册的先注销;ResourceGroupManager::shutdownAll()——把资源组从内存里清空;"*-*-* OGRE Shutdown"横幅——与构造时的 Initialising 呼应,标记引擎正式关停。
注意 mFirstTimePostWindowInit 这个标志:插件卸载只在「窗口已初始化过」时才执行,防止从未初始化就关停时重复卸载。
~Root():按创建倒序释放
析构函数不重复调 shutdown(shutdown 已被用户或 Root 析构链调用过),而是补上「按创建倒序 reset 管理器」的收尾:
// OgreMain/src/OgreRoot.cpp:~Root(v14.6.3 源码摘录,已删减)
Root::~Root()
{
shutdown();
#if OGRE_NO_DDS_CODEC == 0
DDSCodec::shutdown();
#endif
...
mCompositorManager.reset(); // needs rendersystem
mParticleManager.reset(); // may use plugins
mMaterialManager.reset(); // may use GPU program manager
mGpuProgramManager.reset(); // may use plugins
...
行内注释把依赖关系写得一清二楚:Compositor 需要渲染系统,粒子可能用插件,材质可能用 GPU 程序管理器。所以析构顺序与构造完全镜像——最后构造的先析构。这就是为什么构造时先建 LogManager(最底层),析构时它最后走。
清理顺序的通用法则
OGRE 的清理顺序可以抽象成两条法则,适用于任何分层系统:
- 依赖者先销毁,被依赖者后销毁:窗口依赖渲染系统,渲染系统依赖窗口系统——先关窗口,再关渲染后端;
- 后台活动先停止:一切会并发访问共享状态的线程,在共享状态销毁前停掉。
这两条法则在本系列反复出现:卷三的分页流式加载、卷四的资源后台队列,清理顺序都是同一套路。违反法则的典型症状是「析构时崩溃但运行正常」——因为悬空引用只在清理路径上被触碰。
退出顺序由资源依赖决定
Root 的关停先停 WorkQueue,再处理场景和资源。析构后续才卸载插件。只等待 worker 退出无法证明主线程任务已经执行,回调中捕获的 ResourcePtr 也会延长引用寿命。
在销毁目标和后端之前完成或处理持有资源的主线程任务。用 场景样例 对照已完成的资源回调和关停时未执行的标记任务。
持有对象的退出依赖
flowchart TD
App["宿主停止产生新资源任务"] --> Drain["等待已提交的准备并处理主线程任务"]
Drain --> Ref["释放实体与持有资源的回调"]
Ref --> S["Root::shutdown"]
S --> Q["WorkQueue 停止并 join worker"]
Q --> M["关停场景管理器"]
M --> P["插件 shutdown"]
P --> R["清理场景及资源组"]
R --> D["Root 析构后续卸载插件"]
源码定位
OgreMain/src/OgreRoot.cpp:Root::shutdown、Root::~RootOgreMain/src/OgreRoot.cpp:mWorkQueue->shutdown()、shutdownPlugins()、ResourceGroupManager::shutdownAll()- 横幅:
"*-*-* OGRE Shutdown"
上游引用固定到 OGRE v14.6.3 源码 。
可运行产物:C++ 最小验证
下面复现 shutdown 的五步清理顺序。它与 src/02-3-shutdown-order.cpp 逐字节一致:
// file: src/02-3-shutdown-order.cpp
// tier: L1
// verify: clang++ -std=c++20 -I. src/02-3-shutdown-order.cpp -o bin/02-3-shutdown-order && ./bin/02-3-shutdown-order
//
// 复现 OgreRoot::shutdown 与 ~Root 的清理顺序:
// 工作队列 → 场景管理器 → 插件 → 资源组 → 日志横幅
// 与析构时「后创建的先销毁」的倒序。独立最小验证,非 OGRE 源码。
#include "verify.h"
#include <string>
#include <vector>
namespace ogre_repro {
class RootRepro {
public:
std::vector<std::string> teardown;
// 对应 OgreRoot.cpp:shutdown()
void shutdown() {
teardown.push_back("workQueue.shutdown"); // 后台线程先停
teardown.push_back("sceneManagerEnum.shutdownAll");
teardown.push_back("shutdownPlugins");
teardown.push_back("resourceGroup.shutdownAll");
teardown.push_back("*-*-* OGRE Shutdown"); // 日志横幅
}
// 对应 ~Root:按创建倒序释放(后创建的先 reset)
~RootRepro() {
if (teardown.empty()) shutdown();
}
};
} // namespace ogre_repro
int main() {
using namespace ogre_repro;
RootRepro root;
root.shutdown();
CHECK(root.teardown[0] == "workQueue.shutdown");
CHECK(root.teardown.back() == "*-*-* OGRE Shutdown");
CHECK_EQ(root.teardown.size(), 5u);
// 生命周期语义:后台线程先停,之后才能安全销毁资源管理器。
// 每个子系统在 teardown 日志中按序出现,且关键环节齐全。
std::vector<std::string> keywords = {"workQueue", "scene", "Plugins",
"resourceGroup", "Shutdown"};
CHECK_EQ(keywords.size(), root.teardown.size());
for (size_t i = 0; i < keywords.size(); ++i) {
const bool present = root.teardown[i].find(keywords[i]) != std::string::npos;
CHECK(present);
}
for (const auto& s : root.teardown) std::printf("%s\n", s.c_str());
return lab::report("02-3 Root 析构与清理顺序");
}
本机实测(Apple clang 16,clang++ -std=c++20):编译通过,断言 9/9 通过,打印五步清理序列。
小结
- shutdown 五步:停工作队列 → 关场景 → 卸插件 → 清资源组 → 关停横幅。
- 析构与构造镜像:最后构造的先析构,行内注释标注依赖关系。
- 两条通用法则:依赖者先销毁;后台活动先停止。
- 后台线程必须在资源销毁前停掉,否则踩悬空引用。
阅读导航:上一节:2.2 Root 启动:选后端、建场景、跑一帧 · 下一节:3.1 OgrePlugin 接口与插件职责 。
继续阅读
探索更多技术文章
浏览归档,发现更多关于系统设计、工具链和工程实践的内容。