C++ 实现可动态加载的插件式工厂模式架构及其导出符号可见性管理【实战】-C++-PHP中文网

插件DLL的工厂函数必须用extern "C"导出以禁用C++名称修饰，否则GetProcAddress将找不到符号；同时需检查LoadLibrary返回值及GetLastError错误码，并确保ABI稳定性与跨模块内存管理安全。

c++ 实现可动态加载的插件式工厂模式架构及其导出符号可见性管理【实战】

插件 DLL 中的工厂函数必须用 `extern "C"` 导出

Windows 下动态加载插件（.dll）时，如果工厂函数用 C++ 普通方式导出（比如只加 __declspec(dllexport)），链接器会做 C++ name mangling，导致主程序调用 GetProcAddress 时找不到符号。例如 create_processor() 可能被编译成 ?create_processor@@YAPAVProcessor@@XZ，完全不可预测。

正确做法是强制以 C 风格导出，禁用 mangling：

extern "C" {
    __declspec(dllexport) Processor* create_processor();
    __declspec(dllexport) void destroy_processor(Processor* p);
}

必须包裹在 extern "C" 块中，不能只对单个函数加
Linux 下对应的是 __attribute__((visibility("default")))，但 Windows 仍需 extern "C"
若忘记加，GetProcAddress(hModule, "create_processor") 返回 nullptr，且无编译或加载错误，极易误判为路径/模块加载失败

`dlopen` / `LoadLibrary` 加载后必须检查句柄有效性

插件路径错误、依赖缺失（如 MSVCRT 版本不匹配）、架构不一致（x64 插件被 x86 主程序加载）都会导致 LoadLibrary 返回 NULL（Windows）或 dlopen 返回 nullptr（Linux）。但很多人只检查是否为空，忽略错误码细节。

Windows 下应立即调用 GetLastError() 辅助定位：

HMODULE h = LoadLibrary(L"processor_plugin.dll");
if (!h) {
    DWORD err = GetLastError();
    // err == 126 → 找不到指定模块（路径错/缺依赖）
    // err == 193 → %1 不是有效的 Win32 应用程序（位数不匹配）
}

LoadLibrary 成功不代表插件逻辑就绪——它只保证 DLL 被映射，不执行任何初始化代码
若插件依赖另一个未安装的 DLL（如 vcruntime140.dll），LoadLibrary 直接失败，不会抛异常
建议在加载后立刻尝试获取一个导出函数指针，双重验证：既加载成功，又符号可见

插件接口基类必须满足 ABI 稳定性约束

主程序和插件分别编译，若共用头文件中的抽象基类（如 Processor），其虚函数表布局、vtable offset、成员对齐等必须严格一致。否则调用虚函数可能崩溃或读错内存。

C++14

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

下载

关键约束包括：

基类不能含非 POD 成员（如 std::string、std::vector），它们的实现随 STL 版本变化
禁止内联虚函数；所有虚函数必须在 .cpp 中定义，确保 vtable 条目地址由插件提供
构造/析构函数不能是 inline，且插件中必须提供 destroy_processor 进行显式销毁（避免跨模块调用 operator delete）
推荐用纯虚接口 + PIMPL 隐藏实现细节，把复杂对象封装在插件内部，只暴露简单 C 风格函数

Linux 下 `dlsym` 找不到符号？检查 `-fvisibility=hidden` 和 `default` 标签

Clang/GCC 默认开启 -fvisibility=hidden，即使写了 __attribute__((visibility("default")))，若没加在函数定义上（而只加在声明上），符号依然不可见。

正确写法（定义处标注）：

// plugin.cpp
extern "C" {
    __attribute__((visibility("default"))) Processor* create_processor() {
        return new ConcreteProcessor();
    }
    __attribute__((visibility("default"))) void destroy_processor(Processor* p) {
        delete p;
    }
}