动态库卸载时单例安全销毁需五种方法：一、Windows用DllMain处理DLL_PROCESS_DETACH；二、Linux用__attribute__((destructor))配显式shutdown；三、RAII封装ModuleGuard控制生命周期；四、thread_local跟踪线程状态延迟销毁；五、导出显式shutdown函数强制宿主协同。
如果您在 Windows 或 Linux 平台开发动态链接库（DLL / SO），且库中使用了单例模式，当宿主程序调用 FreeLibrary 或 dlclose 卸载该模块时，单例对象可能因析构顺序失控、静态资源提前释放或跨模块依赖断裂而引发崩溃或资源泄漏。以下是确保其在动态库卸载阶段安全销毁的多种实战方法：
一、Windows 下在 DllMain 中注册 DLL_PROCESS_DETACH 清理
该方法利用 Windows 系统提供的 DLL 生命周期钩子，在模块被显式卸载（非进程退出）时主动触发单例销毁逻辑，避免依赖全局静态析构序列。
1、在 DllMain 函数中捕获 DLL_PROCESS_DETACH 事件；
2、判断 lpReserved 是否为 nullptr，以区分是 FreeLibrary 调用还是进程终止；
立即学习“C++免费学习笔记（深入）”；
3、仅在 FreeLibrary 场景下调用单例类的 destroyInstance() 方法；
4、确保 destroyInstance() 内部使用 std::atomic
5、销毁后立即将内部指针置为 nullptr，并在 getInstance() 中检查返回值有效性。
二、Linux 下使用 __attribute__((destructor)) 配合显式 shutdown 接口
该方法借助 GCC/Clang 编译器扩展，在共享库卸载前自动运行指定函数，但因其执行顺序不可控，需配合外部显式调用机制形成双重保障。
1、定义一个带 __attribute__((destructor)) 的 C 风格函数，内部调用 Singleton::shutdown()；
2、在 shutdown() 中加锁并检查是否已销毁，实现 幂等性与线程安全性；
3、要求宿主程序在 dlclose 前主动调用一次 Singleton::shutdown()，作为主清理路径；
4、将 destructor 函数设为备用路径，仅用于兜底，不依赖其执行时机；
5、避免在 destructor 函数中访问其他共享库导出的符号或单例实例。
三、基于局部静态变量 + RAII 封装的模块级生命周期管理
该方法将单例实例完全托管于函数内静态局部变量，同时通过一个独立的 RAII 类封装其生存期，使卸载行为可由宿主程序精确控制。
1、定义一个 ModuleGuard 类，构造时调用 Singleton::getInstance()，确保初始化；
2、ModuleGuard 析构函数中调用 Singleton::destroyInstance()，但仅在模块尚未卸载前提下生效；
3、在 DLL/SO 的导出初始化函数中返回 ModuleGuard 实例的 std::unique_ptr；
4、宿主程序持有该智能指针，并在其决定卸载前释放它；
5、确保 ModuleGuard 的析构发生在所有跨模块静态对象析构之前，不参与全局静态析构链。
四、引入 thread_local 辅助状态跟踪与延迟销毁
该方法适用于单例内部持有线程私有资源（如 TLS 缓冲区、本地日志上下文）的场景，通过线程局部标记避免主线程卸载时误触仍在运行的工作线程中的单例引用。
1、在 Singleton 类中声明 static thread_local bool s_thread_active；
2、每个线程首次访问单例时将其置为 true，线程退出前置为 false；
3、destroyInstance() 执行前遍历所有已知活跃线程标识，等待其全部置为 false 后再继续；
4、使用条件变量或原子计数器同步线程状态变更；
5、销毁过程中禁止新线程进入 getInstance()，可通过全局 atomic_flag 控制入口。
五、DLL/SO 导出显式 shutdown 函数并强制宿主协同
该方法放弃对自动卸载钩子的依赖，转而采用契约式接口设计，将销毁责任明确移交至宿主程序，是最可控、最易调试的方案。
1、在头文件中声明 extern "C" void STDCALL ShutdownSingleton();（Windows）或 __attribute__((visibility("default"))) void shutdown_singleton();（Linux）；
2、实现函数中调用 Singleton::destroyInstance()，并执行所有关联资源关闭操作；
3、在文档中明确要求宿主程序必须在 FreeLibrary/dlclose 前调用该函数；
4、在 destroyInstance() 内添加运行时断言：若检测到当前处于 DLL_PROCESS_DETACH 或 dlclose 流程中仍未调用，则触发 abort() 防止静默崩溃；
5、提供调试宏，在开发版本中记录调用栈与时间戳，辅助验证调用合规性。
