迁移至64位RedHat7后出现undefined symbol: configDir错误求助

核心原因分析 #

1. 违反单定义规则（ODR）的重复定义 #

你在config/ConfigManager.C和config/ConfigBackup.C两个文件中都定义了char *configDir;，这直接违反了C++的单定义规则——全局变量只能在唯一一个源文件中定义，其他文件仅用extern声明。

• RHEL6（32位）使用的旧版GCC/链接器对重复定义的全局变量采用了宽松的弱符号处理策略，允许这种错误存在并能正常解析符号；
• RHEL7（64位）的GCC 4.8+和ld 2.25+对ODR的检查更严格，重复定义的符号会被链接器丢弃或标记为无效，最终导致运行时找不到符号。

2. 全局作用域非法赋值导致的符号异常 #

你的代码中在全局作用域直接写了赋值语句：

char *configDir;
configDir = getcwd(0, 64); // 全局作用域不允许执行这类赋值语句

C++仅允许全局变量在定义时通过初始化器赋值（如char *configDir = getcwd(0,64);），直接的全局作用域赋值属于非法语法。旧版32位编译器可能宽松处理并执行，但RHEL7的64位编译器会将这类代码视为未初始化的全局变量，或导致符号初始化逻辑未被正确纳入最终二进制，间接引发符号未定义问题。

3. RHEL版本间符号可见性与链接器行为变化 #

RHEL7的GCC默认对共享库符号采用hidden可见性（除非显式指定default），但你添加__attribute__((visibility("default")))无效的原因是：重复定义的符号已经被链接器处理异常，可见性属性无法覆盖ODR违规带来的问题。

解决方案 #

1. 修复重复定义，统一变量声明与定义 #

• 在唯一一个源文件（如ConfigManager.C）中定义变量并指定可见性：

  // ConfigManager.C
  __attribute__((visibility("default"))) char *configDir = nullptr;
  
  // 单独的初始化函数，确保在使用前调用
  void init_config_dir() {
      configDir = getcwd(nullptr, 64);
      if (configDir == nullptr) {
          configDir = ::getenv("PWD");
      }
  }
  

• 在其他需要使用configDir的文件中，仅用extern声明：

  // linkmanager.c 或其他文件
  extern char *configDir;
  

2. 确保初始化时机正确 #

在程序启动阶段（如main函数开头，或全局构造函数中）调用init_config_dir()，保证configDir在被ftok等函数使用前完成初始化。

3. 验证符号导出状态 #

使用nm工具检查共享库是否正确导出configDir符号：

nm -D <你的共享库路径> | grep configDir

如果输出中包含D configDir或T configDir，说明符号已正确导出；若没有输出，需要检查编译链接时的可见性设置与重复定义问题。

4. 调整链接器选项（可选） #

如果项目依赖多个共享库，确保链接时添加--export-dynamic选项（针对主程序）或-rdynamic（GCC编译选项），保证全局符号能被动态链接器正确解析。

内容的提问来源于stack exchange，提问作者vaggelismeklis