必须由宿主程序显式调用shutdown接口销毁单例,dllmain中仅当lpreserved为nullptr时调destroyinstance,linux destructor钩子仅作警告且禁用stl,所有清理须在crt堆失效前完成。

Windows下在DllMain中响应DLL_PROCESS_DETACH销毁单例
当宿主调用FreeLibrary卸载DLL时,必须确保单例对象在CRT堆失效前被安全delete,否则将触发访问已释放内存的崩溃。这一步不能依赖进程退出时的自动析构,因为那时std::mutex、堆管理器早已不可用。
第一步:在单例类中定义静态函数destroyInstance(),内部使用std::atomic
第二步:destroyInstance()中先对单例持有的std::thread调用joinable()判断再join(),对std::mutex使用try_lock避免死锁,所有文件句柄、socket描述符必须显式close(),不得留待析构函数处理。
第三步:执行delete m_instance;后立即将m_instance = nullptr;,并在getInstance()开头添加if (!m_instance) throw std::runtime_error("Singleton destroyed");防护。
第四步:在DllMain函数的case DLL_PROCESS_DETACH分支中,【必须严格判断if (lpReserved == nullptr)】,仅在此条件下调用Singleton::destroyInstance();若lpReserved非空,说明是进程终止,此时任何delete都会段错误。
Linux下用__attribute__((destructor))注册轻量卸载钩子
这个函数只在dlopen加载的.so被dlclose时触发,但它不是“安全销毁主路径”,而是兜底提醒——如果宿主忘了调shutdown,它最多帮你发个警告,绝不能在里面做复杂清理。
方法一:定义static void __attribute__((destructor)) so_unload_hook() { if (Singleton::is_shutdown_called()) return; write(2, "WARNING: Singleton not shutdown before dlclose\n", 48); }。注意这里用write(2)而非std::cout,因为后者可能已析构。
方法二:若坚持在destructor里调destroyInstance(),必须确保该函数不依赖任何STL对象——禁止std::string构造、禁止std::cout输出、禁止调用其他动态库导出函数。它只能检查instance != nullptr → delete → 置空指针。
编译时若启用-fvisibility=hidden,【必须给so_unload_hook加__attribute__((visibility("default")))】,否则链接器可能直接剥离该符号,导致钩子完全不生效。
跨平台提供extern "C" shutdown接口并由宿主严格调用
这是唯一可测试、可审计、不依赖运行时环境的方案。所有崩溃都源于“谁来控制时机”,而答案只能是宿主程序自己。
1. 在单例头文件中声明extern "C" { void shutdown_singleton(); },Windows加__declspec(dllexport),Linux加__attribute__((visibility("default")))。
2. shutdown_singleton()函数体内只做三件事:加自旋锁(避免std::mutex析构风险)→ delete instance → instance = nullptr。不调日志、不抛异常、不访问任何外部符号。
3. 宿主程序拿到dlopen返回的handle后,必须用dlsym(handle, "shutdown_singleton")获取函数指针,绝不能硬编码调用。
4. 调用顺序必须为:shutdown_singleton() → dlclose(handle)(Linux)或FreeLibrary(hDll)(Windows)。中间插入任何操作都可能导致二次析构或悬垂指针。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











