为什么使用 apt 安装的 Python 第三方包版本会滞后？如何解决这一问题？

为什么使用 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 
    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)
...

查看 certbot 的版本：

立即学习“Python免费学习笔记（深入）”；

pon@aliyun2core2GB:~$ pip show certbot
Name: certbot
Version: 1.21.0
Summary: ACME client
...

发现 certbot 版本为 1.21.0，这是一个相对较旧的版本。

为什么会出现这种情况呢？Ubuntu 是如何管理 apt 中可下载的 Python 第三方包版本的呢？通常情况下，apt 应该自动解决依赖问题并下载一个兼容的最新版本。

Quinvio AI

AI辅助下快速创建视频，虚拟代言人

下载

实际上，经过测试发现 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 在加载包时有目录优先级，优先级如下：

1. /usr/local/lib/python3.10/dist-packages
2. /usr/lib/python3/dist-packages（优先级最低）

因此，当 certbot 尝试导入 urllib3 时，会优先加载 /usr/local/lib/python3.10/dist-packages 中的 urllib3，导致版本冲突。

解决这个问题的方法有以下几种：

1. 避免在系统中使用 pip 安装第三方包，只使用 apt 进行包管理。
2. 使用虚拟环境，这样可以避免系统包与用户安装的包之间的冲突。
3. 只使用 pip 管理包，但需要确保不会与系统包产生冲突。

通过了解这些信息，用户可以更好地管理和解决使用 apt 安装的 Python 第三方包版本滞后问题。