单例对象应在程序退出或动态库卸载前显式销毁，推荐使用Meyers单例（函数内静态局部变量）配合析构函数轻量清理；DLL需在DllMain中判空lpReserved再调用destroyInstance；Linux下用__attribute__((destructor))需确保同编译单元且禁用-fvisibility=hidden；跨平台首选显式shutdown接口，由宿主严格控制调用时机。
程序退出或动态库卸载时单例对象未销毁，会导致数据库连接未关闭、线程未 join、内存池未释放、后续访问悬垂指针崩溃——这不是偶发 bug，而是生命周期管理机制选错导致的必然结果。
程序退出时确保单例安全析构
用函数内静态局部变量（Meyers 单例）替代堆分配或全局静态对象，C++11 运行时会在 main() 返回后自动按构造逆序调用析构函数，不参与跨编译单元析构序列，彻底避开“依赖对象已销毁却还要访问”的经典崩溃源。
第一步：在 getInstance() 中声明 static Singleton instance;，而非 static Singleton* m_instance = new Singleton();
第二步：确保 ~Singleton() 中只执行轻量清理操作，例如 close(fd)、munmap()、notify()，不调用其他单例接口、不访问全局日志器、不依赖任何外部静态对象——因为它们的析构顺序完全不可控。
立即学习“C++免费学习笔记（深入）”；
第三步：返回 instance 的引用，禁止返回 &instance 并长期缓存裸指针；若需传参构造，改用 static std::unique_ptr<Singleton> instance; + std::make_unique()，但必须保证该 unique_ptr 本身定义在函数作用域内，而非全局命名空间。
注意：std::quick_exit() 或 _Exit() 会跳过所有析构函数，若业务要求强资源保障，不能仅依赖此机制。
Windows 动态库卸载时安全销毁
DllMain 是唯一可控入口。FreeLibrary 卸载 DLL 时，系统会调用 DllMain 并传入 DLL_PROCESS_DETACH；但进程退出时也会触发该事件，此时 CRT 堆可能已失效，直接 delete 会崩溃。
方法一：在 DllMain 的 DLL_PROCESS_DETACH 分支中判空 lpReserved
if (lpReserved == nullptr) 才执行 Singleton::destroyInstance()，否则跳过——这能准确区分是宿主主动卸载还是进程终止。
方法二：destroyInstance() 内部必须用 std::atomic<bool> s_destroyed{false} 标记状态，首次调用时 exchange(true) 成功才继续，防止多次 FreeLibrary 导致重复 delete。
【销毁前必须显式处理非平凡资源：thread.join()、mutex.unlock()（或放弃锁）、close(fd)，绝不能依赖析构函数隐式释放】
Linux 动态库卸载时安全注销
__attribute__((destructor)) 是 GCC/Clang 提供的卸载钩子，适用于 dlopen 加载的 .so；但它不区分 dlclose 还是进程退出，且执行顺序不可控，无法保证所依赖的符号（如 Logger::get()）仍有效。
定义一个独立的 C 风格函数：static void __attribute__((destructor)) so_unload_cleanup() { Singleton::destroyInstance(); }
该函数必须与单例实现位于同一编译单元，否则链接时可能被剥离；编译时禁用 -fvisibility=hidden。
destroyInstance() 内部需检查原子标志并加锁，且禁止调用 std::cout、std::string 析构、STL 容器或任何依赖 C 运行时堆的代码——这些在 dlclose 后极可能已不可用。
若单例持有 std::thread，必须先判断 joinable() 再调用 join()，避免对已终止线程重复操作。
跨平台最可靠方案：显式 shutdown 接口
把销毁时机完全交由宿主程序控制，是插件系统、嵌入式模块或高可靠性场景下的首选。它规避了所有运行时析构不确定性，且可与业务逻辑深度协同。
① 在单例类中声明 public: static void shutdown();，内部使用 std::atomic 标记销毁状态，并加锁保护 delete 操作。
② shutdown() 执行 delete 后立即将 m_instance 置为 nullptr，并在 getInstance() 开头增加 if (!m_instance) throw std::runtime_error("singleton destroyed");
③ 以 extern "C" 方式导出 C 风格函数：Windows 下用 __declspec(dllexport)，Linux 下用 __attribute__((visibility("default")))，确保宿主可通过 GetProcAddress 或 dlsym 直接获取地址。
④ 宿主程序必须在调用 FreeLibrary 或 dlclose 之前，严格调用一次该 shutdown 函数——延迟哪怕一帧，都可能导致后续段错误。
