单例模式在动态库卸载时如何安全注销并销毁？

本文共计1277个文字，预计阅读时间需要6分钟。

在动态库卸载时，不会自动销毁，必须显式调用`FreeLibrary`，否则保留的静态指针将变为空指针，下次访问时将导致崩溃。

为什么动态库里的单例不能靠析构函数自动清理

动态库（DLL/so）加载后，其全局/静态对象的生命周期由操作系统管理：Windows 下 DLL 的全局对象析构函数只在 FreeLibrary 返回前、且 DLL 引用计数降为 0 时才被调用；但这个“析构时机”不可靠——若单例是通过 new 分配在堆上、仅靠静态指针持有（如懒汉式），析构函数根本不会触发该堆对象的 delete；更糟的是，若 DLL 被多次 LoadLibrary/FreeLibrary，静态变量可能被重复初始化或未重置，导致 getInstance() 返回已释放内存地址。

• 饿汉式单例（静态对象）在 DLL 卸载时会调用析构函数，但前提是它没被 new 出来而是直接定义的（如 static Singleton instance;）
• 所有基于 static Singleton* instance = nullptr; + new 的懒汉式，析构函数不负责释放堆内存，必须手动 delete
• 智能指针（如 std::unique_ptr）在 DLL 卸载时能触发 reset()，但仅当它是 DLL 内部的静态变量，且析构顺序可控

DllLoader 类里怎么安全绑定单例销毁逻辑

不能把单例销毁塞进 DllLoader 析构函数——因为 DllLoader 实例本身可能在主程序中创建，而单例属于 DLL 模块内部，二者生命周期不一致。正确做法是让 DLL 暴露一个显式的注销函数，并在 FreeLibrary 前调用它。

• DLL 导出函数签名应为：extern "C" __declspec(dllexport) void CleanupSingleton();（避免 C++ name mangling）
• CleanupSingleton() 内部调用单例类的 destroyInstance()，例如：Singleton::destroyInstance();
• 调用顺序必须严格为：CleanupSingleton() → FreeLibrary(hDll)；中间不能有异常跳过
• 若使用 RAII 封装，可在 DllLoader 析构前加一层检查：if (cleanup_func) cleanup_func();，其中 cleanup_func 是通过 GetProcAddress 获取的函数指针

thread_local 不能替代单例销毁，但可辅助线程局部资源清理

thread_local 变量在线程退出时自动析构，但它和单例不是同一维度的东西：单例是进程级唯一，thread_local 是每线程一份。有人试图用 thread_local Singleton* 来绕过销毁问题，这是错的——它制造了 N 个实例，不再是单例；而且主线程的 thread_local 在 DLL 卸载后仍可能被其他模块误访问。

立即学习“C++免费学习笔记（深入）”；

• 真正有用的是在单例内部用 thread_local 管理线程私有资源（如缓存、上下文），这些资源会随线程结束自动清理，不依赖 DLL 卸载时机
• 但单例自身的存在性（即那个全局唯一对象）仍需通过显式 destroyInstance() 控制
• 注意 thread_local 析构顺序：若单例内某个 thread_local 对象依赖另一个全局单例，而后者已在 DLL 卸载中被销毁，则前者析构时访问会 crash

最简可行的跨平台注销方案（Win/Linux）

核心就两条：导出注销函数 + 主动调用。Linux 下对应 dlsym/dlclose，行为与 Windows 一致。

• 在 DLL/so 源码中添加：void CleanupSingleton() { Singleton::destroyInstance(); }，并确保该函数被导出（Windows 加 __declspec(dllexport)，Linux 加 __attribute__((visibility("default")))）
• 主程序中获取并调用：auto cleanup = (void(*)())GetProcAddress(hDll, "CleanupSingleton"); if (cleanup) cleanup(); FreeLibrary(hDll);
• 务必检查 destroyInstance() 是否幂等：重复调用不应崩溃，建议内部加 if (instance == nullptr) return;
• 若单例持有文件句柄、内存池等资源，destroyInstance() 必须先释放资源，再将指针置 nullptr，否则后续 getInstance() 可能误复用已释放资源

真正容易被忽略的点是：单例的 destroyInstance() 和 DLL 卸载之间没有原子性保证。如果其他线程正在调用 getInstance()，你却在另一线程执行 destroyInstance()，结果就是竞态。所以，要么加锁（如 std::mutex 保护整个销毁流程），要么设计成“只允许在所有使用者停止后才调用”，后者更常见也更安全。