manylinux_2_28容器构建Python包时auditwheel修复失败求助

构建过程中出现如下错误：

error: cannot repair "pynemo-0.0.0.dev0-cp311-cp311-linux_x86_64.whl" to "manylinux_2_28_x86_64" ABI because of the presence of too-recent versioned symbols. 

使用auditwheel-symbols检测后发现，pynemo依赖的多个系统库（如libdl-2.28.so、libm.so.6等）因链接GLIBC_PRIVATE相关符号，不满足manylinux_2_28合规要求。所有依赖库均来自容器默认的/lib64目录，构建前执行的脚本如下：

yum -y install curl zip unzip tar autoconf automake libtool pkg-config perl-open python3.11-pip
python3.11 -m pip install jinja2
for python in /opt/python/*/bin/python3*; do
    if [ -x "$python" ]; then
        echo "Using Python: $python"
        $python -m pip install jinja2
    fi
done
ln -sf /usr/bin/python3.11 /usr/bin/python3
git clone https://github.com/microsoft/vcpkg.git
./vcpkg/bootstrap-vcpkg.sh
./vcpkg/vcpkg install

修复方案 #

• 调整vcpkg编译配置：vcpkg默认可能使用系统GLIBC编译依赖，引入私有符号。在执行vcpkg install前设置编译环境变量，限制符号可见性并强制符合ABI标准：

  export CFLAGS="-fPIC -D_GLIBCXX_USE_CXX11_ABI=0 -fvisibility=hidden"
  export CXXFLAGS="-fPIC -D_GLIBCXX_USE_CXX11_ABI=0 -fvisibility=hidden"
  

  也可以修改vcpkg的triplet配置文件（如x64-linux.cmake），添加：

  set(VCPKG_C_FLAGS "-fPIC -fvisibility=hidden")
  set(VCPKG_CXX_FLAGS "-fPIC -fvisibility=hidden")
  set(VCPKG_CXX_FLAGS_RELEASE "-D_GLIBCXX_USE_CXX11_ABI=0")
  

• 过滤系统核心库的auditwheel检测：manylinux标准允许依赖系统核心库（如libm.so.6、libdl.so.2），auditwheel的误判可通过--exclude选项规避：

  auditwheel repair --exclude libdl.so.2 --exclude libm.so.6 pynemo-0.0.0.dev0-cp311-cp311-linux_x86_64.whl
  

  注意：仅确认这些库为容器默认的manylinux_2_28版本时使用此方法。

• 检查并修改pynemo的构建配置：排查setup.py或CMakeLists.txt，确认是否存在强制链接GLIBC_PRIVATE符号的代码。例如，对于libdl，确保使用dlopen等公共API，而非直接引用私有符号；编译时添加-fvisibility=hidden参数，减少不必要的符号暴露。

• 静态编译依赖库：通过vcpkg静态编译所有依赖，避免动态链接系统库的私有符号。执行安装时指定静态triplet：

  ./vcpkg/vcpkg install --triplet x64-linux-static
  

  同步修改pynemo的构建配置，链接静态库文件。

• 验证系统依赖版本：执行ldd path/to/pynemo_extension.so（替换为实际的扩展模块路径），检查所有依赖库的版本是否与manylinux_2_28容器默认版本一致。若存在高版本库，卸载对应的系统包，恢复容器默认状态。

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