Ubuntu 22.04下GCC 11无法链接含构造函数的库问题排查

问题概述 #

在Ubuntu 22.04（GCC 11.4.0-1ubuntu1~22.04）和Ubuntu 20.04（GCC 9.4）环境下，构建仅包含库构造函数的动态库后，主程序无法触发构造函数执行：

• 复现示例在Godbolt在线编译环境、Docker容器、本地Clang构建下均正常，仅本地GCC构建出现异常
• 使用以下脚本构建：

g++ -fPIC -shared -o libexample-gcc.so example.cpp \
  && g++ -std=c++17 -o main.gcc main.cpp -L. -lexample-gcc -Wl,-rpath,.

• 关键现象：ldd main.gcc显示本地GCC生成的主程序无该动态库依赖（Clang生成的主程序有）；通过-Wl,--verbose确认链接器已找到目标库，且库中library_constructor()符号存在，添加--no-as-needed参数也未解决问题

原因分析 #

GCC配套的ld链接器默认启用--as-needed选项：该选项会检查主程序是否直接引用了动态库中的符号。如果主程序没有任何显式引用（仅依赖构造函数自动执行），链接器会判定该库为"非必需"，不会将其加入主程序的依赖列表，导致运行时不会加载该库，构造函数自然无法触发。

而Clang链接器默认未启用如此严格的--as-needed逻辑，Docker容器环境的链接器配置可能存在差异，Godbolt环境则可能默认禁用了该选项，因此这些场景下都能正常执行构造函数。

解决方案 #

方法1：精准强制保留目标库依赖 #

修改主程序编译命令，注意--no-as-needed必须放在目标库参数之前，后续可通过--as-needed恢复默认逻辑，避免影响其他库：

g++ -std=c++17 -o main.gcc main.cpp -L. -Wl,--no-as-needed -lexample-gcc -Wl,--as-needed -Wl,-rpath,.

方法2：在主程序中显式引用库符号 #

即使是无意义的符号地址引用，也能让链接器判定库为必需。在main.cpp中添加：

extern void library_constructor();
int main() {
    (void)&library_constructor; // 仅引用符号地址，不执行函数
    return 0;
}

之后按原脚本编译即可。

方法3：编译动态库时使用--whole-archive #

该选项会强制链接器包含库中所有符号，适合体积较小的库：

g++ -fPIC -shared -o libexample-gcc.so example.cpp -Wl,--whole-archive

编译主程序时无需额外修改参数。

验证方式 #

修改后运行主程序，检查是否输出构造函数的预期内容；同时执行ldd main.gcc，确认libexample-gcc.so已出现在依赖列表中。

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