Meyer单例是唯一符合C++11标准的方案,通过函数内静态局部变量实现自动析构;动态库卸载需显式shutdown接口配合原子标志与资源预清理,禁用析构函数中STL调用。

程序退出或动态库卸载时单例对象未销毁,会导致数据库连接未关闭、线程未 join、内存池残留、后续访问悬垂指针崩溃——这不是偶发 bug,而是生命周期管理机制选错导致的必然结果。
主程序退出时确保单例安全析构
采用 Meyer 单例(函数内静态局部变量)是唯一符合 C++11 标准且无需手动干预的方案。
第一步:在 getInstance() 中声明 static Singleton instance;,而非 static Singleton* m_instance = new Singleton();
第二步:返回 instance 的引用,禁止返回 &instance 后长期缓存裸指针,否则可能在析构后仍被误用。
立即学习“C++免费学习笔记(深入)”;
这一步最关键:static 局部变量的析构由 __cxa_atexit(Linux)或类似机制注册,main() 返回后按构造逆序自动执行,不参与跨编译单元的全局静态析构序列——它彻底绕开了“ConfigManager 析构时 FileSystem 已销毁”这类依赖崩溃。
注意:若单例析构函数中调用了其他单例(如 Logger::instance().flush()),而该单例定义在另一编译单元且先析构,仍会崩溃。所有依赖必须也使用 Meyer 方式实现,并在构造函数内按需获取。
Windows 动态库卸载时安全销毁单例
必须用 DllMain 响应 DLL_PROCESS_DETACH,且仅在 FreeLibrary 主动卸载时触发,排除进程退出场景。
方法一:在 DllMain 的 case DLL_PROCESS_DETACH 分支中写入判断逻辑 → if (lpReserved == nullptr) { Singleton::destroyInstance(); }
方法二:destroyInstance() 内部必须用 std::atomic
销毁前必须显式处理非平凡资源:【std::thread 必须先 check joinable() 再调用 join(),否则未 join 的线程在 delete 时会直接 terminate】;mutex 不要 unlock,直接放弃;文件描述符、socket、映射内存必须 close/munmap/closesocket,不能依赖析构函数。
getInstance() 必须加空指针检查:if (!m_instance) throw std::runtime_error("singleton destroyed");,避免宿主在卸载后继续调用引发段错误。
Linux 动态库卸载时安全销毁单例
__attribute__((destructor)) 函数仅对 dlopen 加载的 .so 生效,且执行时机不可控,只能作为兜底,绝不能作为主销毁路径。
方法一:定义 void __attribute__((destructor)) so_unload_hook() { Singleton::shutdown(); },该函数必须位于与 Singleton 实现同一编译单元,否则链接时可能被剥离。
方法二:Singleton::shutdown() 内部先加锁(若支持并发访问),再检查原子销毁标志,确认未销毁才执行 delete m_instance; → m_instance = nullptr;
方法三:宿主程序必须严格按顺序操作 → 调用 dlsym(handle, "Config_shutdown") 获取函数指针 → 执行 shutdown() → 立即调用 dlclose(handle);中间插入任何其他操作都可能导致悬垂指针被访问。
【禁止在 destructor 函数中调用 std::cout、std::string 析构或任何 STL 对象,它们可能已在该时刻被析构完毕】
跨平台最可靠方案:显式 shutdown 接口
把销毁控制权完全交还给宿主程序,是唯一可测试、可调试、可审计的方案。
① 在单例类中声明 public static void shutdown();,内部使用 std::call_once 和 std::atomic
② shutdown() 中只做两件事:delete m_instance; → m_instance = nullptr; 其他所有资源释放逻辑(thread.join、fd.close 等)必须在此前完成,不得延迟到析构函数。
③ 用 extern "C" 导出 C 风格函数:Windows 写 extern "C" __declspec(dllexport) void Config_shutdown();,Linux 写 extern "C" __attribute__((visibility("default"))) void Config_shutdown();,避免 name mangling 导致 dlsym 失败。
④ 宿主调用 dlclose 或 FreeLibrary 前,必须通过 GetProcAddress / dlsym 获取该函数并执行一次。这一步不可省略,也不可延后。


















