Conda环境导入pandas与cplex触发GLIBCXX_3.4.29缺失的ImportError

成因 #

1. 动态链接库加载规则：Linux系统中，动态链接器加载共享库时，若进程已加载同名库，后续不会再加载其他版本；同时会优先遵循二进制文件自身的RUNPATH/RPATH设置查找依赖库。
2. 依赖库版本与路径冲突：
   • pandas的扩展模块设置了RUNPATH指向conda环境内部的lib目录，会优先加载conda提供的libstdc++.so.6.0.32（包含GLIBCXX_3.4.29及更高版本符号）。
   • cplex的扩展模块RUNPATH/RPATH指向系统lib目录，依赖系统的libstdc++.so.6.0.28（不包含GLIBCXX_3.4.29符号）。
3. 加载顺序导致的符号缺失：
   • 先导入pandas时，conda的高版本libstdc++先被加载；后续导入cplex时，cplex会尝试从自身RUNPATH指向的系统旧版本库中查找符号，因旧版本无GLIBCXX_3.4.29触发报错。
   • 先导入cplex时，系统旧版本libstdc++先被加载；后续导入pandas时，pandas的RUNPATH会引导动态链接器加载conda的高版本库，而高版本库向后兼容旧版本符号，因此不会触发错误。

解决方案 #

1. 强制统一使用conda的libstdc++（推荐） #

在启动Python前设置LD_PRELOAD环境变量，强制进程优先加载conda环境内的libstdc++.so.6：

# 替换为你的conda环境实际路径
export LD_PRELOAD=/home/user/miniconda3/envs/your_env/lib/libstdc++.so.6
python your_script.py

也可以将该命令添加到conda环境的激活脚本（如env/bin/activate.d/env_vars.sh），每次激活环境自动生效。

2. 修改cplex模块的RUNPATH #

使用patchelf工具修改cplex扩展模块的RUNPATH，让它优先查找conda环境的lib目录：

# 替换为你的conda环境和cplex模块的实际路径
patchelf --set-rpath '$ORIGIN/../../../../lib' /home/user/miniconda3/envs/your_env/lib/python3.9/site-packages/cplex/_internal/_cplex.so

注：$ORIGIN表示当前.so文件所在目录，需根据cplex模块的层级调整相对路径，确保指向conda环境的lib目录。

3. 临时 workaround：固定导入顺序 #

在Python脚本开头先导入cplex，再导入pandas：

import cplex
import pandas as pd

此方法无需修改环境或文件，但仅为临时解决，若后续依赖库更新可能再次出现问题。

4. 重新编译cplex（若有源码权限） #

若能获取cplex的Python绑定源码，在conda环境中重新编译，让其链接到conda提供的libstdc++，从根源解决依赖冲突。

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