C++实现轻量级的插件式工厂框架 _ DLL动态加载与接口反射【实战】-C++-PHP中文网

c++oding="utf-8" ?>

必须用 extern "c" 导出工厂函数，因 c++ name mangling 会导致 getprocaddress/dlsym 找不到符号；接口基类须为纯虚类，工厂函数返回指针由主程序 delete，需确保 new/delete abi 一致；插件须提供 extern "c" 的 destroy_plugin 配套函数清理资源。

c++实现轻量级的插件式工厂框架 _ dll动态加载与接口反射【实战】

直接用 LoadLibrary + GetProcAddress（Windows）或 dlopen + dlsym（Linux）就能搭出可用的插件工厂，但“轻量”不等于“随便写”，关键在符号导出、类型安全和错误兜底——三者漏一，运行时崩溃就是常态。

为什么必须用 extern "C" 导出工厂函数

C++ 编译器会对函数名做 name mangling，比如 create_plugin() 可能变成 ?create_plugin@@YAPAVPluginBase@@XZ。而 GetProcAddress 和 dlsym 只认原始符号名，找不到就返回 NULL。

必须显式加 extern "C"：避免 mangling，保证符号名与字符串字面量一致
Windows 示例：extern "C" __declspec(dllexport) PluginBase* create_plugin_0();
Linux 示例：extern "C" __attribute__((visibility("default"))) PluginBase* create_plugin_0();
别依赖 #pragma comment(linker, "/EXPORT:...") —— 它只影响 .lib 生成，不影响运行时符号可见性

如何安全调用 dlsym / GetProcAddress 返回的函数指针

拿到函数指针后不能直接强转调用，C++ 类型系统不会帮你检查 ABI 兼容性。一旦插件和主程序的 PluginBase 布局不一致（比如虚表偏移不同），plugin->run() 就会跳到随机内存地址。

C++14

C++14 对 C++11 的修正与增强版本，适合旧系统维护和较老工具链兼容。

下载

接口基类必须是纯抽象类（只有 virtual 函数 + virtual ~PluginBase() = default;），且不带数据成员
工厂函数返回的是基类指针，但实际对象内存由插件 DLL 分配，主程序负责 delete —— 必须确保 new/delete 跨模块 ABI 一致（推荐统一用静态链接 MSVCRT 或 libc++）
调用前务必检查指针非空：if (create_func) { auto p = create_func(); if (p) p->run(); }
不要把 HMODULE 或 void* 存全局变量长期持有；DLL 卸载后指针立即失效

Linux 下 dlopen 失败的常见原因和排查顺序

dlopen 返回 NULL 不代表文件不存在，更可能是依赖链断裂或符号不可见。

先确认路径：传绝对路径最稳，相对路径需确保当前工作目录正确（getcwd 打印一下）
检查是否编译为位置无关：g++ -fPIC -shared plugin.cpp -o libplugin.so，漏 -fPIC 会导致 dlopen 静默失败
确认符号导出：nm -D libplugin.so | grep create_plugin，没输出说明 visibility("default") 没生效
查依赖缺失：ldd libplugin.so，看是否有 not found 行
获取错误信息必须用 dlerror()，不是 errno；且 dlerror() 是“消费型”接口，调一次就清空，要立刻保存

插件卸载时最容易被忽略的资源泄漏点

多数人只记得 dlclose 或 FreeLibrary，但忘了插件内部可能持有资源：线程、文件句柄、全局单例、STL 容器析构异常等。

强制要求插件提供 destroy_plugin(PluginBase*) 配套函数（同样 extern "C" 导出），由主程序调用后再 delete
禁止插件在 DllMain / __attribute__((constructor)) 中做任何跨模块操作（如调用主程序函数、初始化 std::cout）
若插件用了第三方库（如 OpenSSL），确保其初始化/清理逻辑被显式封装进 init/destroy 函数中
Windows 上 FreeLibrary 成功 ≠ DLL 已卸载，只是引用计数减一；只有计数归零才真正释放，所以别假设“调完就没了”

真正的轻量不靠删代码，而靠约束边界：用 C 接口切掉 C++ ABI 依赖，用纯虚基类守住二进制兼容，用显式 init/destroy 控制生命周期。剩下那些“自动发现插件目录”“热重载”“版本校验”的需求，都是在这些地基打牢之后才值得加的上层功能。