Ansible无法找到已安装的python3-rpm库问题求助

我在测试Ansible的ansible.builtin.package_facts模块时，编写了如下Playbook：

- name: Gather the package facts
  ansible.builtin.package_facts:
    manager: auto

- name: Print the package facts
  ansible.builtin.debug:
    var: ansible_facts.packages

- name: Check whether a package called foobar is installed
  ansible.builtin.debug:
    msg: "{{ ansible_facts.packages }}"

执行第一个任务时失败，错误信息如下：

TASK [test_role : Gather the package facts] ************************************
[WARNING]: Found "rpm" but Failed to import the required Python library (rpm)
on vsa12701896's Python /data/venv/bin/python3. Please read the module
documentation and install it in the appropriate location. If the required
library is installed, but Ansible is using the wrong Python interpreter, please
consult the documentation on ansible_python_interpreter
fatal: [localhost]: FAILED! => {"changed": false, "msg": "Could not detect a supported package manager from the following list: ['rpm', 'apk', 'portage', 'pkg', 'pacman', 'apt', 'pkg_info'], or the required Python library is not installed. Check warnings for details."}

我已确认系统安装了python3-rpm包，Python版本为3.9：

(venv) vsa12701896:/data/src # zypper search python3-rpm
Loading repository data...
Reading installed packages...

S | Name        | Summary                                       | Type
--+-------------+-----------------------------------------------+--------
i | python3-rpm | Python Bindings for Manipulating RPM Packages | package

    Note: For an extended search including not yet activated remote resources
    please use 'zypper search-packages'.
(venv) vsa12701896:/data/src # pip3 list|grep rpm
rpm                       0.2.0
(venv) vsa12701896:/data/src # python --version
Python 3.9.19

更新信息 #

1. 主机仅安装Python 3.9，无其他Python解释器
2. 虚拟环境中已安装rpm包：

(venv) vsa12701896:/data/venv/bin # python3 -m pip freeze | grep rpm
rpm==0.2.0

3. 进一步检查发现导入rpm模块报错：

(venv) vsa12701896:/data/venv/bin # python3 -c "import rpm; print(rpm.__version__)"
Traceback (most recent call last):
File "/data/venv/lib64/python3.9/site-packages/rpm/__init__.py", line 106, in 
_shim_module_initializing_
NameError: name '_shim_module_initializing_' is not defined

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
File "", line 1, in 
File "/data/venv/lib64/python3.9/site-packages/rpm/__init__.py", line 109, in 
initialize()
File "/data/venv/lib64/python3.9/site-packages/rpm/__init__.py", line 98, in initialize
raise ImportError(
ImportError: Failed to import system RPM module. Make sure RPM Python bindings are installed on your system.

核心原因 #

问题出在虚拟环境中通过pip安装的第三方rpm包，与系统自带的原生python3-rpm绑定库冲突。PyPI上的rpm包是一个兼容层，它需要调用系统原生的RPM Python模块，但虚拟环境默认隔离了系统包，导致这个兼容层无法找到原生模块，同时自身初始化逻辑存在问题，最终Ansible无法正常加载rpm库。

解决步骤 #

1. 卸载虚拟环境中的第三方rpm包
   这个包完全多余，直接在虚拟环境中执行卸载：

   pip uninstall -y rpm
   

2. 让虚拟环境继承系统Python包
   如果是新建虚拟环境，创建时加上--system-site-packages参数，让虚拟环境能访问系统级的python3-rpm模块：

   python3 -m venv --system-site-packages /data/venv
   

   如果是已存在的虚拟环境，修改/data/venv/pyvenv.cfg文件，将include-system-site-packages = false改为true，之后重新激活虚拟环境即可。

3. 验证修复效果
   重新激活虚拟环境后，执行以下命令确认rpm模块可正常导入：

   python3 -c "import rpm; print(rpm.__version__)"
   

   能正常输出版本号后，再重新运行Ansible Playbook即可解决问题。

额外说明 #

Ansible的package_facts模块依赖系统原生的包管理Python绑定，而非PyPI上的第三方兼容包。在使用虚拟环境时，必须确保Ansible能访问到这些系统级模块，否则会出现包管理器检测失败的错误。

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