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

夜静同学_9674

夜静同学_9674

2026-05-25

867人浏览

原创

getprocaddress 返回 nullptr 但 getlasterror() 为 0,主因是 c++ name mangling 导致函数名不匹配,需用 extern "c" 和 __declspec(dllexport) 双重导出并验证符号表。

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

GetProcAddress 返回 nullptr,但 GetLastError() 是 0?不是路径错,也不是模块没找到——八成是工厂函数没用 extern "C" 导出,符号被 C++ name mangling 搞没了。

为什么 GetProcAddress 找不到 create_plugin() 函数

Windows 下 C++ 编译器默认对函数名做 name mangling,比如 create_plugin() 可能变成 ?create_plugin@@YAPAVProcessor@@XZ。而 GetProcAddress 只认原始字符串名,根本不会去猜修饰后的名字。

  • 必须用 extern "C" 包裹导出函数,禁用 mangling
  • 不能只加 extern "C" 而漏掉 __declspec(dllexport):前者管名字,后者管是否进导出表,缺一不可
  • 常见误写:extern "C" __declspec(dllexport) void foo(); 写在头文件里但没加 #pragma once 或 include 守卫,导致多个 TU 重复定义导出符号,链接失败
  • 验证方式:用 dumpbin /exports processor_plugin.dll(Windows)或 nm -D libplugin.so(Linux),确认输出列表里有干净的 create_plugin,而不是一堆带问号和@符号的乱码

插件接口基类不能含 std::string 或虚继承

主程序和插件各自编译,若共用一个抽象基类(如 IPlugin),它的内存布局必须完全一致。一旦虚函数表偏移、成员对齐或析构逻辑不一致,调用 p->run() 就可能跳到非法地址。

C++14
C++14

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

下载
  • 接口类必须是纯虚类:所有函数都带 = 0,无实现体,无默认参数
  • 禁止任何非 POD 成员:删掉 std::string m_name;,换成 char m_name[64]; 或 const char*
  • 禁用虚继承、模板成员、内联函数、RTTI、异常处理——这些都会让不同编译器/版本生成不同的 vtable 布局
  • 若用 MSVC,确保主程序和插件都用相同运行时(如 /MT 静态链接 CRT),否则 new/delete 跨 DLL 释放会崩溃

工厂函数返回裸指针,但 destroy_plugin 必须由插件自己实现

不能让工厂返回 std::shared_ptr<iplugin></iplugin>,因为其自定义 deleter(比如调用 destroy_plugin)会在主程序堆上执行插件 DLL 的代码——CRT 版本不一致时直接触发访问冲突。

  • 工厂函数只返回裸指针:extern "C" __declspec(dllexport) IPlugin* create_plugin();
  • 插件必须配套导出销毁函数:extern "C" __declspec(dllexport) void destroy_plugin(IPlugin* p);,内部用 delete p 或对应 allocator
  • 主程序应封装 RAII 类(如 PluginPtr),构造时调 create_plugin,析构时调 destroy_plugin,不依赖 STL 智能指针跨模块传递
  • 切勿在插件 DLL 中静态初始化全局对象(尤其含 STL 容器的),避免与主程序的初始化顺序冲突

LoadLibrary 成功不代表插件就 ready

LoadLibrary 返回非空句柄,只说明 DLL 已映射进进程空间;它不保证依赖 DLL 已加载、也不执行 DllMain 中的初始化逻辑(除非你显式触发)。

  • 加载后必须立刻调 GetProcAddress 获取至少一个函数指针(如 create_plugin),双重验证:既加载成功,又符号可见
  • 若插件依赖 vcruntime140.dll 但系统缺失,LoadLibrary 直接返回 NULL,错误码为 ERROR_DLL_NOT_FOUND (126)
  • 位数不匹配(x86 主程序加载 x64 插件)错误码是 ERROR_BAD_EXE_FORMAT (193),不是异常,也不会弹窗
  • 不要长期持有 HMODULE:DLL 卸载后该句柄立即失效;每次调用前应检查有效性,或用 RAII 自动管理生命周期

最容易被忽略的是 ABI 稳定性——它不报错、不崩溃在加载瞬间,而是在第一次调虚函数时随机崩,且堆栈看不出源头。务必把接口头文件、编译器版本、运行时选项、结构体对齐方式全部钉死,别信“只是个小改动”。

C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

c++

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
c++和c语言的区别有哪些
c++和c语言的区别有哪些

c++和c语言的区别:1、面向对象编程(OOP)支持不同;2、新增特性不同;3、标准库不同;4、编译方式不同;5、命名空间不同等等。想了解更多c++的相关内容,可以阅读本专题下面的文章。

2024.03.14

2248

9

c++和python学习顺序推荐
c++和python学习顺序推荐

一般建议先学习C++,再学习Python,因为这样可以逐步从较为底层的编程语言向更高级的语言过渡。想了解更多python的相关内容,可以阅读本专题下面的文章。

2024.03.14

1039

6

python和c++学习性价比分析
python和c++学习性价比分析

Python易于学习,广泛应用于Web开发、数据科学和人工智能等领域,但性能较低。C语言性能高,适用于对性能要求较高的场景,如游戏开发和系统编程,但学习曲线陡峭,错误处理复杂。想了解更多python的相关内容,可以阅读本专题下面的文章。

2024.03.14

447

5

c语言和c++一样吗
c语言和c++一样吗

c语言和c++是两种不同的编程语言,虽然有相似之处,但存在显著差异。c语言专注于过程式编程和系统级开发,以简洁、高效著称。c++作为c语言的超集,引入了面向对象编程,增强了代码组织和管理能力,但学习曲线也更陡峭。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.03.14

327

5

c语言和c++先学哪个好
c语言和c++先学哪个好

初学者选择学习c语言还是c++语言,需要根据个人学习目标、背景以及编程兴趣和预期应用方向来决定。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.03.14

426

5

c语言和c++的区别和联系
c语言和c++的区别和联系

c语言和c++是计算机科学领域应用广泛的编程语言。虽然它们有着相似的基础,但它们在语言类型、语法功能和内存管理方面存在着显著差异。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.03.14

600

5

c++软件中文更改教程
c++软件中文更改教程

对于 ide,可通过打开设置,找到语言设置,选择中文,并保存更改。对于非 ide 应用程序,可查找设置或选项,选择语言设置,更改为中文,并保存更改。想了解更多c++的相关内容,可以阅读本专题下面的文章。

2024.03.21

1409

9

python和java和c++学习性价比分析
python和java和c++学习性价比分析

Python以其易学性、丰富的库和活跃的社区而著称,适合数据科学、人工智能和Web开发。Java以其跨平台性、企业级应用开发和Android应用开发而闻名。C++以其底层控制能力、高效性能和游戏开发而著称。选择哪种语言取决于个人兴趣、职业方向和特定需求。想了解更多python和java和c++的相关内容,可以阅读本专题下面的文章。

2024.03.22

1237

7

c++和c语言学习顺序推荐
c++和c语言学习顺序推荐

对于初学者,建议先学习C语言,掌握编程基础后再转入C++,便于理解面向对象编程概念。有编程经验者可直接学习C++,快速接触高级编程技术。想了解更多c++和c语言的相关内容,可以阅读本专题下面的文章。

2024.03.25

1325

9

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C++ Core Guidelines
C++ Core Guidelines

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

C++ 官方标准说明
C++ 官方标准说明

共0课时 | 0人学习