确保动态库单例安全销毁的五种方案：一、Windows用DllMain监听DLL_PROCESS_DETACH并校验lpReserved；二、Linux用__attribute__((destructor))配合显式shutdown；三、跨平台用unique_ptr加卸载钩子；四、线程局部存储替代全局单例；五、插件架构下由宿主通过工厂注册表统一管理生命周期。
如果您在 Windows 或 Linux 平台开发动态链接库（DLL / SO），且库中使用了单例模式，当宿主程序调用 FreeLibrary 或 dlclose 卸载模块时，单例对象可能未被销毁，进而引发资源泄漏、句柄残留、线程挂起甚至访问已释放内存的崩溃。以下是确保单例在动态库卸载时安全销毁的多种实战方案：
一、Windows 下在 DllMain 中注册 DLL_PROCESS_DETACH 清理
该方法直接利用系统 DLL 生命周期钩子，在模块卸载前主动触发单例销毁，适用于所有 Windows DLL 场景，且能准确区分进程退出与显式卸载。
1、在 DllMain 函数中监听 DLL_PROCESS_DETACH 事件。
2、判断 lpReserved 是否为 nullptr，仅当其为空时表示由 FreeLibrary 触发卸载，而非进程终止。
3、在此分支中调用单例类的 destroyInstance() 方法，确保幂等性与线程安全。
4、destroyInstance() 内部需使用 std::atomic
5、销毁完成后将静态指针置为 nullptr，并在 getInstance() 中检查并抛出异常或返回引用前断言。
二、Linux 下使用 __attribute__((destructor)) 配合显式 shutdown 接口
该方法利用 GCC/Clang 提供的 destructor 属性，在共享库卸载时执行清理函数；但因其执行顺序不可控，必须配合外部显式 shutdown 调用以规避依赖冲突。
1、定义一个全局 C 风格函数，标记为 __attribute__((destructor))。
2、该函数内不直接调用单例析构逻辑，而是检查是否已调用过 shutdown() 接口。
3、若未调用，则记录警告日志，并跳过销毁——强制要求宿主程序在 dlclose 前调用 Singleton::shutdown()。
4、Singleton::shutdown() 内部执行加锁、资源释放、指针置空等完整清理流程。
5、getInstance() 在返回前检查销毁标志，若已 shutdown 则抛出 std::runtime_error("Singleton already destroyed")。
三、跨平台 RAII 封装：使用 std::unique_ptr + atexit/dlclose 钩子组合
该方案将单例生命周期托管给智能指针，并通过平台适配的卸载钩子触发 reset，兼顾自动内存管理与卸载可控性。
1、将单例实例存储于 static std::unique_ptr
2、在 getInstance() 首次构造后，立即注册平台相关卸载回调：Windows 下注册至 DllMain 的 DLL_PROCESS_DETACH；Linux 下在 dlopen 后调用 dlclose 前手动绑定清理函数。
3、注册函数内调用 ptr.reset()，触发 unique_ptr 的析构与对象销毁。
4、确保 Singleton 析构函数不访问其他静态对象，仅关闭句柄、join 线程、unmap 内存等轻量操作。
5、禁止在析构函数中调用其他单例的 getInstance()，否则极易触发野指针访问。
四、DLL 内部线程局部存储（thread_local）替代全局单例
当单例仅需在线程内唯一、且无需跨线程共享时，改用 thread_local 可彻底规避 DLL 卸载时的析构顺序问题，因 thread_local 对象在线程退出时自动销毁，不受模块卸载影响。
1、将原本的 static Singleton* 实现替换为 static thread_local Singleton instance。
2、getInstance() 返回 thread_local 实例的引用，不再使用堆分配。
3、移除所有全局静态指针及 destroyInstance() 接口。
4、确保线程在 DLL 卸载前已全部退出，或在主线程中显式调用每个 worker 线程的 join 操作。
5、此方式下单例生命周期与线程绑定，无法用于跨线程通信或全局配置共享场景。
五、工厂注册表 + 显式注销协议（面向插件架构）
适用于宿主程序加载多个插件 DLL 的场景，由宿主统一管理单例生命周期，插件仅提供注册与注销接口，不自行处理卸载逻辑。
1、宿主程序维护一个全局 FactoryRegistry 单例，支持 addFactory() 与 removeFactory()。
2、每个插件 DLL 导出两个 C 风格函数：Plugin_Init() 和 Plugin_Cleanup()。
3、Plugin_Init() 中调用 FactoryRegistry::addFactory(&pluginFactory)，并将自身单例指针注册进 registry。
4、Plugin_Cleanup() 中调用 FactoryRegistry::removeFactory(&pluginFactory)，registry 内部触发该单例的 shutdown()。
5、宿主在 dlclose 前调用 Plugin_Cleanup()，确保所有插件单例在模块卸载前完成资源释放与指针解绑。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
