降级Python库时出现依赖冲突及pip版本问题的原因是什么？

先看你遇到的具体错误输出：

ERROR: pip的依赖解析器目前未考虑所有已安装的包，此行为导致以下依赖冲突。
pyppeteer 0.2.5 requires importlib-metadata<3.0.0,>=2.1.1; python_version < "3.8", but you have importlib-metadata 4.12.0 which is incompatible.
pyppeteer 0.2.5 requires urllib3<2.0.0,>=1.25.8, but you have urllib3 1.24.3 which is incompatible.
Successfully installed appdirs-1.4.4 attrs-22.1.0 black-22.1.0 click-8.1.3 importlib-metadata-4.12.0 pathspec-0.10.1 regex-2022.8.17 toml-0.10.2 typed-ast-1.5.4 typing-extensions-4.3.0 zipp-3.8.1
WARNING: 您正在使用pip版本22.0.4；当前已有可用版本22.2.2。建议通过'/Users/admin/.local/share/virtualenvs/scrapers-XJakbnzz/bin/python -m pip install --upgrade pip'命令进行升级。

问题原因 #

• pip依赖解析能力不足：你用的pip 22.0.4版本较旧，依赖解析逻辑存在缺陷，无法全面兼顾所有已安装包的版本限制。这次安装black相关依赖时，它直接升级了importlib-metadata到4.12.0，完全没考虑已有的pyppeteer 0.2.5对该库的版本要求（必须小于3.0.0）；同时urllib3当前版本1.24.3也达不到pyppeteer要求的最低1.25.8，最终触发冲突提示。
• 不同库的版本需求冲突：你操作时安装/降级的库（比如black）需要高版本的importlib-metadata，但项目里已有的pyppeteer 0.2.5对importlib-metadata和urllib3有严格的版本范围限制，两者的版本需求无法同时满足，自然出现冲突。
• 旧版pip放大问题：旧版pip的依赖解析逻辑不如新版完善，新版本pip（比如提示的22.2.2）能更好地处理这类多包版本冲突，甚至提前避免部分问题。

解决办法 #

1. 先升级pip到最新版，这是解决多数依赖解析问题的基础：

   /Users/admin/.local/share/virtualenvs/scrapers-XJakbnzz/bin/python -m pip install --upgrade pip
   

2. 修复pyppeteer的依赖冲突，可二选一：
   • 降级importlib-metadata并升级urllib3到符合pyppeteer要求的版本：

     pip install importlib-metadata<3.0.0,>=2.1.1 urllib3>=1.25.8,<2.0.0
     

   • 升级pyppeteer到更高版本，通常新版本会放宽依赖约束，适配更现代的库版本：

     pip install --upgrade pyppeteer
     

3. 如果需要保留特定版本组合，可以一次性指定所有需要的包版本，让新版pip自动协调：

   pip install pyppeteer==0.2.5 importlib-metadata==2.1.1 urllib3==1.25.8 black==22.1.0
   

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