Python2.7导入CPLEX报无法导入_aux_functions错误的解决咨询
问题场景
- 目标环境:Python 2.7.9
- 已执行操作:
- 完成IBM ILOG CPLEX Optimization Studio安装,安装完成提示显示版本为20.1.0,安装路径为
/opt/ibm/ILOG/CPLEX_Studio201(注:原描述提到下载的是12.6.1学术版,与实际安装版本存在不一致) - 执行Python适配命令:
python /opt/ibm/ILOG/CPLEX_Studio201/python/setup.py install,命令执行完成后,程序完成docplex 2.18.200包的字节编译与安装,将文件写入/usr/local/lib/python2.7/dist-packages/目录 - 执行代码导入
import cplex时触发如下报错:
- 完成IBM ILOG CPLEX Optimization Studio安装,安装完成提示显示版本为20.1.0,安装路径为
Traceback (most recent call last): File "test.py", line 12, in <module> import cplex File "/opt/ibm/ILOG/CPLEX_Studio201/cplex/python/3.7/x86-64_linux/cplex/__init__.py", line 44, in <module> from .aborter import Aborter File "/opt/ibm/ILOG/CPLEX_Studio201/cplex/python/3.7/x86-64_linux/cplex/aborter.py", line 13, in <module> from ._internal import _procedural as _proc File "/opt/ibm/ILOG/CPLEX_Studio201/cplex/python/3.7/x86-64_linux/cplex/_internal/__init__.py", line 18, in <module> from . import _aux_functions ImportError: cannot import name _aux_functions
核心问题根因
- 版本适配完全错位:CPLEX 12.9及之后的版本(包括当前安装的20.1.0)已彻底移除Python 2系列的绑定支持,安装目录下仅预置了Python 3.x版本的编译型C扩展绑定,从报错堆栈的加载路径
cplex/python/3.7/x86-64_linux/即可验证,当前环境硬加载Python 3编译的二进制模块必然触发导入失败。 - 安装操作错误:执行
/opt/ibm/ILOG/CPLEX_Studio201/python/setup.py时,由于当前20.1.0版本不存在Python 2.7可用的编译扩展,脚本仅完成了无平台依赖的纯Python docplex上层建模包的安装,未实现核心cplex C扩展绑定的适配。 - 路径优先级冲突:Python包搜索路径中,CPLEX自带的3.7版本绑定目录优先级高于已安装的第三方包目录,导致导入时直接跳过第三方包路径,加载了不兼容的3.7版本绑定文件。
解决步骤
- 版本匹配校验
- 若必须使用Python 2.7.9环境,需完全卸载当前安装的CPLEX 20.1.0,重新安装12.8及更早版本的CPLEX Studio,这类版本的安装目录下才会预置Python 2.7对应的x86-64_linux平台编译绑定。
- 正确执行绑定安装
- 不要执行CPLEX根目录下的通用setup.py脚本,直接进入对应Python版本的绑定目录执行安装,示例命令:
python2.7 /opt/ibm/ILOG/CPLEX_Studio<匹配版本>/cplex/python/2.7/x86-64_linux/setup.py install
- 不要执行CPLEX根目录下的通用setup.py脚本,直接进入对应Python版本的绑定目录执行安装,示例命令:
- 排查路径冲突
- 安装完成后执行
python2.7 -c "import sys; print(sys.path)",确认包搜索路径中不存在高优先级的Python 3版本CPLEX绑定目录;检查/usr/local/lib/python2.7/dist-packages/下的cplex相关.pth配置文件,确保路径指向Python 2.7版本的绑定目录。
- 安装完成后执行
- 验证配置
- 执行
python2.7 -c "import cplex; print(cplex.__version__)",能正常输出版本号即代表配置完成。
- 执行
内容的提问来源于stack exchange,提问作者Henrique Lima
相关产品推荐
相关产品推荐

