如何解决Python依赖冲突：无法解析兼容发行版

问题根源 #

你遇到的是典型的Python依赖版本冲突：grpcio-status==1.62.0要求protobuf>=4.21.6，但当前环境解析到的是protobuf 3.20.3，两者不兼容。结合你提到的google-cloud-vision 2.3.1，大概率是这个包间接引入了高版本的grpcio-status，打破了你之前正常运行时的依赖版本平衡（grpcio 1.39.0 + protobuf 3.17.3）。

具体解决方案 #

1. 明确锁定兼容的依赖版本

在项目根目录创建/修改requirements.txt，写入以下内容：

google-cloud-vision==2.3.1
grpcio-status==1.39.0
protobuf==3.17.3
grpcio==1.39.0

这样强制让所有相关依赖回到你之前验证过的兼容版本组合，避免包管理工具自动升级导致冲突。

2. 清理缓存并重新安装依赖

先彻底清理现有依赖和缓存，再重新安装指定版本：

# 清理pip缓存
pip cache purge
# 卸载冲突的包
pip uninstall -y grpcio grpcio-status protobuf google-cloud-vision
# 重新安装指定版本
pip install -r requirements.txt

3. 修正BUILD文件的依赖配置

如果你用Bazel等构建工具，确保BUILD文件中的依赖版本和requirements.txt完全对齐：

py_library(
    name = "your_project_lib",
    deps = [
        "@pypi_google_cloud_vision//:pkg",
        "@pypi_grpcio_status//:pkg",
        "@pypi_protobuf//:pkg",
        "@pypi_grpcio//:pkg",
    ],
)

同时在WORKSPACE文件中绑定pip_install到你的requirements.txt：

pip_install(
    requirements = "//:requirements.txt",
)

4. 排查间接依赖（如果上述方法无效）

用以下命令查看google-cloud-vision的依赖树，定位是哪个包强制引入了高版本grpcio-status：

pip show google-cloud-vision
pip show grpcio-status

找到根源后，安装时直接排除该自动引入的高版本包，再手动安装兼容版本：

pip install google-cloud-vision==2.3.1 --no-deps
pip install grpcio-status==1.39.0 protobuf==3.17.3 grpcio==1.39.0

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