为什么使用 apt 安装的 python 第三方包版本会出现滞后现象?
在 ubuntu 22.04 系统中,用户可能会发现通过 apt 安装的 Python 第三方包版本相对较旧。这种情况在处理 Let’s Encrypt 证书时尤为明显。例如,执行 sudo apt install certbot python3-certbot-nginx 后,使用 certbot 命令时,可能会遇到版本不兼容的错误。
例如,用户在执行以下命令时:
sudo certbot certonly --manual --preferred-challenges dns -d xxxxx.cn -d *.xxxxx.cn
可能会看到类似如下的错误信息:
Traceback (most recent call last): File "/usr/lib/python3/dist-packages/requests_toolbelt/_compat.py", line 48, in <module> from requests.packages.urllib3.contrib import appengine as gaecontrib ImportError: cannot import name 'appengine' from 'requests.packages.urllib3.contrib' (/usr/local/lib/python3.10/dist-packages/urllib3/contrib/__init__.py) ...</module>
查看 certbot 的版本:
立即学习“Python免费学习笔记(深入)”;
pon@aliyun2core2GB:~$ pip show certbot Name: certbot Version: 1.21.0 Summary: ACME client ...
发现 certbot 版本为 1.21.0,这是一个相对较旧的版本。
为什么会出现这种情况呢?Ubuntu 是如何管理 apt 中可下载的 Python 第三方包版本的呢?通常情况下,apt 应该自动解决依赖问题并下载一个兼容的最新版本。
实际上,经过测试发现 certbot 1.21.0 版本本身是正常工作的,并不存在不兼容的问题。问题的关键在于,在使用 apt 安装 certbot 之前,可能已经使用 pip 安装了 urllib3 这个依赖包。
查看错误信息,可以看到 urllib3 的文件路径位于 /usr/local/lib/python3.10/dist-packages,而 certbot 的文件路径位于 /usr/lib/python3/dist-packages。这是因为通过 apt install python-xxx 安装的包文件存放在 /usr/lib/python3/dist-packages,而通过 sudo pip install xxx 安装的包文件存放在 /usr/local/lib/python3.10/dist-packages。
Python 在加载包时有目录优先级,优先级如下:
- /usr/local/lib/python3.10/dist-packages
- /usr/lib/python3/dist-packages(优先级最低)
因此,当 certbot 尝试导入 urllib3 时,会优先加载 /usr/local/lib/python3.10/dist-packages 中的 urllib3,导致版本冲突。
解决这个问题的方法有以下几种:
- 避免在系统中使用 pip 安装第三方包,只使用 apt 进行包管理。
- 使用虚拟环境,这样可以避免系统包与用户安装的包之间的冲突。
- 只使用 pip 管理包,但需要确保不会与系统包产生冲突。
通过了解这些信息,用户可以更好地管理和解决使用 apt 安装的 Python 第三方包版本滞后问题。