激活ansible_venv后执行postgresql_query模块报错：无法导入psycopg2

问题场景 #

激活ansible_venv虚拟环境运行Ansible剧本时，localhost执行collect data from DB任务（使用community.postgresql.postgresql_query模块）报错：无法在XXX/ansible-venv/bin/python3.7解释器中导入psycopg2库。已从联网机器下载psycopg2-binary并复制到虚拟环境site-packages目录，权限与其他模块一致，其他机器执行该模块正常，目标机器无网络。

排查与解决步骤 #

1. 直接验证虚拟环境内的psycopg2可用性 #

先跳过Ansible，直接在localhost的虚拟环境中测试psycopg2能否导入：

source XXX/ansible-venv/bin/activate
python3.7 -c "import psycopg2; print(psycopg2.__version__)"
deactivate

• 如果这一步报错，说明问题出在虚拟环境的psycopg2本身，而非Ansible配置。

2. 改用离线wheel包安装psycopg2 #

手动复制site-packages文件容易遗漏依赖或出现版本不兼容，建议用wheel包离线安装：

• 在联网机器上，针对Python3.7下载对应平台的wheel包：

  pip download psycopg2-binary==<适配版本> --python-version 37 --platform <目标平台，如manylinux2014_x86_64> --no-deps
  

• 将下载的.whl文件复制到localhost，在虚拟环境中执行安装：

  source XXX/ansible-venv/bin/activate
  pip install /path/to/psycopg2-binary-xxx.whl
  

3. 检查系统级依赖库 #

psycopg2-binary依赖系统的libpq库，localhost可能缺失该依赖：

• Debian/Ubuntu系统：从离线源下载libpq5的deb包，执行dpkg -i libpq5_xxx.deb安装
• CentOS/RHEL系统：从离线源下载postgresql-libs的rpm包，执行rpm -ivh postgresql-libs-xxx.rpm安装

4. 强制指定Ansible使用虚拟环境的Python解释器 #

即使激活了虚拟环境，Ansible可能仍调用系统Python。在任务中显式指定解释器：

- name: collect data from DB
  community.postgresql.postgresql_query:
    login_host: '{{ db_host }}'
    login_user: '{{ db_username }}'
    login_password: '{{ db_password }}'
    db: '{{ db_database }}'
    port: '{{ db_database_port }}'
    query: "SELECT EXISTS (SELECT 1 FROM information_schema.tables WHERE table_name = '{{ my_table }}')"
  register: qres
  vars:
    ansible_python_interpreter: XXX/ansible-venv/bin/python3.7

5. 确认虚拟环境权限 #

确保运行Ansible的用户对虚拟环境目录有读写权限：

chown -R <运行Ansible的用户>:<用户组> XXX/ansible-venv

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