Python2.7环境Jenkins任务导入psycopg2报AttributeError求助

问题场景 #

运行基于Python 2.7的Jenkins任务，任务会在工作区克隆包含site-packages文件夹的Git仓库，导入psycopg2时触发以下错误：

import psycopg2
  File "/U01/jenkins/workspace/Certinal-Dashboard@script/3fd472cfae7a05e124db2e1ea25b136ecb9661026cf719c0011581747a11dea0/site-packages/psycopg2/__init__.py", line 50, in <module>
    from psycopg2._psycopg import (                     # noqa
  File "/U01/jenkins/workspace/Certinal-Dashboard@script/3fd472cfae7a05e124db2e1ea25b136ecb9661026cf719c0011581747a11dea0/site-packages/psycopg2/_psycopg/__init__.py", line 9, in <module>
  File "/U01/jenkins/workspace/Certinal-Dashboard@script/3fd472cfae7a05e124db2e1ea25b136ecb9661026cf719c0011581747a11dea0/site-packages/psycopg2/extensions.py", line 37, in <module>
    from psycopg2._psycopg import (                             # noqa
  File "/U01/jenkins/workspace/Certinal-Dashboard@script/3fd472cfae7a05e124db2e1ea25b136ecb9661026cf719c0011581747a11dea0/site-packages/psycopg2/_psycopg/AsIs.py", line 9, in <module>
AttributeError: 'module' object has no attribute 'extensions'

当前使用psycopg2 2.7.5版本，仓库中对应文件结构为：

• psycopg2
• psycopg2-2.7.5.dist-info

已尝试更换psycopg2版本（2.8、2.7.7）及重新安装2.7.5，问题未解决。

解决步骤 #

1. 确认模块搜索路径优先级 #

Jenkins环境可能存在多Python环境或路径优先级问题，导致系统默认site-packages覆盖了仓库中的依赖。在导入psycopg2前添加代码，检查并调整路径：

import sys
# 打印当前模块搜索路径
print(sys.path)
# 将仓库的site-packages插入到路径最前面
sys.path.insert(0, "/U01/jenkins/workspace/Certinal-Dashboard@script/3fd472cfae7a05e124db2e1ea25b136ecb9661026cf719c0011581747a11dea0/site-packages")
import psycopg2

2. 重新编译安装psycopg2 #

psycopg2依赖C扩展，克隆仓库中的包可能是在其他系统/架构下编译的，与Jenkins运行环境不兼容。直接在工作区重新安装：

# 确保已安装PostgreSQL开发库，如Debian/Ubuntu下先执行：apt-get install libpq-dev
pip install --target=/U01/jenkins/workspace/Certinal-Dashboard@script/3fd472cfae7a05e124db2e1ea25b136ecb9661026cf719c0011581747a11dea0/site-packages psycopg2==2.7.5

3. 检查_psycopg模块完整性 #

从错误栈看，问题出在_psycopg模块导入，可能仓库中psycopg2/_psycopg目录缺失编译后的二进制文件（如.so）。对比本地正常运行的psycopg2目录结构，确认缺失文件后，用重新安装的方式覆盖。

4. 排查命名冲突 #

检查Jenkins工作区是否存在与psycopg2、_psycopg同名的文件/目录（如psycopg2.py），这类文件会导致Python导入错误模块，发现后直接删除或重命名。

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