确保动态库卸载时单例安全销毁的方法有五种：一、Windows下DllMain中显式调用destroyInstance；二、Linux下用__attribute__((destructor))注册卸载函数；三、提供显式shutdown接口由宿主控制；四、结合atexit与模块加载标记双重保障；五、RAII封装模块生命周期绑定单例生存期。
如果您在 Windows 或 Linux 下使用 DLL/SO 实现单例模式，但动态库卸载后单例对象未被销毁，可能引发资源泄漏、野指针访问或崩溃；这是因为静态变量析构顺序不可控，且卸载过程绕过标准析构流程。以下是确保其在模块卸载时安全销毁的多种方法：
一、Windows 下在 DllMain 中显式调用 destroyInstance
该方法利用 Windows DLL 生命周期钩子，在 FreeLibrary 触发卸载时主动销毁单例实例，避免依赖全局静态析构顺序。必须确保 destroyInstance 是幂等、线程安全且不触发跨模块依赖。
1、在单例类中定义静态销毁函数，内部使用 std::atomic
2、在 DllMain 函数中捕获 DLL_PROCESS_DETACH 事件。
立即学习“C++免费学习笔记（深入）”；
3、检查 lpReserved 是否为 nullptr，仅当由 FreeLibrary 显式卸载时才执行销毁（排除进程退出场景）。
4、调用 Singleton::destroyInstance()，销毁后将内部指针置为 nullptr。
5、在 getInstance() 中增加 nullptr 检查，若已销毁则抛出异常或返回空引用（依业务策略而定）。
二、Linux 下使用 __attribute__((destructor)) 注册卸载函数
该方法利用 GCC/Clang 提供的 destructor 属性，在 dlclose 调用后自动执行指定函数，适用于 dlopen 加载的共享库。但需注意其执行时机不可控，不保证在所有依赖对象析构前完成。
1、定义一个独立的 free-function 销毁器，例如 void cleanup_singleton() { Singleton::destroyInstance(); }。
2、在该函数声明后添加 __attribute__((destructor)) 修饰符。
3、确保该函数位于与单例实现相同的编译单元中，防止链接时剥离。
4、在 destroyInstance 内部使用 std::atomic
5、销毁前获取单例内部互斥锁（如存在），确保与 getInstance 的并发访问互斥。
三、提供显式 shutdown 接口并由宿主程序控制调用
该方法将销毁责任完全移交宿主程序，规避运行时环境对析构顺序的不可预测性，适用于高可靠性要求场景，如插件系统或嵌入式模块管理。
1、在单例类中声明 public static void shutdown()，内部调用 destroyInstance 并重置所有静态状态。
2、shutdown 函数内检查 s_shutdown_called.exchange(true, std::memory_order_acq_rel) 以实现幂等性。
3、宿主程序在调用 FreeLibrary 或 dlclose 前，明确调用 Singleton::shutdown()。
4、getInstance() 在检测到已 shutdown 后，不再重建实例，而是直接返回错误或抛出 std::runtime_error。
5、所有持有单例裸指针的外部模块必须在 shutdown 后清空缓存指针，避免后续误用。
四、结合 atexit 与模块加载标记实现双重保障
该方法在模块首次初始化时注册 atexit 回调，作为卸载失败时的兜底机制；同时配合模块加载标识，防止多次注册或跨模块冲突。
1、在 getInstance 首次成功构造实例后，调用 atexit 并传入 lambda：[] { if (is_module_loaded()) Singleton::destroyInstance(); }。
2、定义静态 std::atomic
3、在 DLL_PROCESS_DETACH 或 destructor 函数中将其置为 false，使 atexit 回调跳过销毁逻辑。
4、atexit 回调中调用 destroyInstance 前，再次检查 s_instance.load(std::memory_order_acquire) != nullptr。
5、禁止在 atexit 回调中调用任何可能抛出异常的函数，防止 std::terminate 被触发。
五、采用 RAII 封装模块生命周期并绑定单例生存期
该方法通过创建一个模块句柄管理类，在其析构时触发单例销毁，将单例生命周期与宿主可控对象强绑定，彻底脱离静态析构链。
1、定义 struct ModuleGuard { ~ModuleGuard() { Singleton::destroyInstance(); } };。
2、在 DLL 入口点或初始化函数中，将 ModuleGuard 实例分配于堆上，并用全局指针保存（如 static ModuleGuard* g_guard = new ModuleGuard();）。
3、在 DLL_PROCESS_DETACH 或 SO destructor 中 delete g_guard，并置为 nullptr。
4、destroyInstance 内部增加对 g_guard == nullptr 的判据，避免重复释放。
5、确保 ModuleGuard 析构函数不抛出异常，且不依赖任何其他全局对象（包括日志、内存池等）。
