应启用符号可见性控制、添加唯一前缀、使用版本脚本、采用RTLD_LOCAL加载策略、限制内部符号作用域。五步协同从编译、命名、链接、加载到作用域层面系统解决动态库同名符号冲突问题。
如果您在大型跨工程项目中遇到多个动态库（DLL 或 .so）导出同名符号导致调用错乱、函数覆盖或运行时行为异常，则问题根源在于动态链接器对全局符号的介入机制——后加载的同名符号会覆盖先加载的符号。以下是解决此问题的步骤：
一、启用编译器符号可见性控制
通过编译选项强制隐藏所有符号，仅显式标记需对外暴露的接口，从源头减少冲突面。GCC/Clang 使用 -fvisibility=hidden 配合 __attribute__((visibility("default")))；MSVC 则依赖 __declspec(dllexport) 与预处理器宏协同管理。
1、在 DLL 工程编译选项中添加 -fvisibility=hidden（Linux/macOS）或定义 MYDLL_EXPORTS 宏（Windows）。
2、在头文件中统一定义导出宏：
若定义了 MYDLL_EXPORTS，则 MYDLL_API 展开为 __declspec(dllexport)；否则展开为 __declspec(dllimport)。
立即学习“C++免费学习笔记（深入）”；
3、对需导出的函数、类或变量显式添加 MYDLL_API 修饰，未修饰者默认不可见。
二、为导出符号添加唯一前缀
避免依赖语言特性隔离，直接在符号命名层面实现物理区分。该方法不依赖编译器或运行时机制，兼容 C/C++/跨语言调用，且可人工验证导出列表。
1、为每个动态库约定统一前缀，例如 libnet_init()、libcfg_load_config()，禁止使用裸名如 init() 或 load_config()。
2、在 C 接口层全部采用该前缀，C++ 类成员函数若需导出，也应在声明中体现前缀逻辑（如通过包装函数或命名空间别名映射）。
3、使用 nm -D libnet.so（Linux）或 dumpbin /exports libnet.dll（Windows）验证导出符号是否已无裸名冲突。
三、使用版本脚本（Version Script）精确控制符号导出
GNU ld 提供的 .map 文件机制可在链接阶段强制约束哪些符号进入动态符号表，实现细粒度可见性裁剪，适用于需要保留内部符号调试信息但禁止外部访问的场景。
1、创建 libnet.map 文件，内容如下：
LIBNET_1.0 { global: libnet_*; local: *; };
2、在链接 DLL 时加入参数：-Wl,--version-script=libnet.map。
3、确保构建系统中该参数仅作用于最终共享库链接步骤，不参与静态库归档或目标文件编译。
四、采用 dlopen(RTLD_LOCAL) 加载策略
在运行时动态加载库时，使用 RTLD_LOCAL 标志可阻止当前库的符号注入全局符号表，从而切断跨库同名符号覆盖链。适用于插件化架构或模块热加载场景。
1、替换原有 dlopen("libplugin.so", RTLD_GLOBAL) 调用为 dlopen("libplugin.so", RTLD_LOCAL)。
2、通过 dlsym() 显式获取所需函数指针，不依赖隐式链接解析。
3、若插件间需互相调用，须由宿主程序提供统一符号注册/查询接口，禁用跨插件直接符号引用。
五、利用匿名命名空间与 static 限定内部符号
对不参与跨模块交互的辅助函数、配置变量、临时对象等，彻底限制其翻译单元作用域，确保其永不进入动态符号表，消除潜在污染源。
1、在 .cpp 文件顶部声明匿名命名空间：namespace { void helper_parse(); }。
2、将仅用于本文件的全局变量、内联工具函数均以 static 修饰，例如：static int internal_counter = 0;。
3、检查编译后目标文件：nm -C your_file.o | grep " T "，确认无未预期的全局符号输出。
