Docker容器内运行pip无法安装指定版本ansible-core模块问题

核心原因 #

• 大概率是Docker镜像内预装的pip版本过低，旧版pip的依赖解析器对~=（兼容版本匹配符）的规则支持存在缺陷，会错误匹配到更高的主版本号
• 少数情况是容器内配置的PyPI镜像源和宿主机不同，源的元数据同步异常导致版本匹配错误

修复步骤 #

1. 先升级容器内的pip到最新版本，在安装ansible-core前添加如下命令：

python3 -m pip --no-cache-dir install --upgrade pip

2. 若升级pip后问题仍存在，可以将版本匹配写法替换为兼容性更强的范围约束，避免旧解析器识别错误：

python3 -m pip --no-cache-dir install --user --upgrade "ansible-core>=2.11.0,<2.12.0"

3. 若上述操作都无效，检查容器内的PyPI源配置，执行pip config list对比和宿主机的索引地址是否一致，必要时在安装命令中指定官方源：

python3 -m pip --no-cache-dir install --user --upgrade -i https://pypi.org/simple/ ansible-core~=2.11

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