在Google Colab导入google-cloud-vision遇ContextualVersionConflict错误求助

问题分析 #

错误核心是环境中存在两个冲突的protobuf版本：系统路径/usr/local/lib/python3.7/dist-packages里的3.17.3，以及你看到的4.21.9。google-cloud-vision要求protobuf版本满足>=3.19.5, <5.0.0dev且排除多个特定版本，旧版本3.17.3不符合要求，且Colab优先加载了这个旧版本，导致冲突。

可行解决步骤 #

1. 彻底卸载所有protobuf版本
   执行以下命令强制清理所有现存的protobuf包：

   !pip uninstall -y protobuf
   

2. 安装符合要求的protobuf版本
   选择不在排除列表中的4.21.9版本（该版本满足google-cloud-vision的版本要求）：

   !pip install protobuf==4.21.9
   

3. 重启Colab运行时
   点击Colab顶部菜单栏的「Runtime」→「Restart runtime」，这一步必须做——Colab会缓存旧的包引用，重启后才能让新安装的版本生效。

4. 验证并重新安装google-cloud-vision
   重启完成后，先确认protobuf版本：

   !pip show protobuf
   

   确认输出版本为4.21.9后，重新安装google-cloud-vision：

   !pip install google-cloud-vision
   

   最后测试导入：

   from google.cloud import vision
   

对之前尝试的补充说明 #

• 你看到的protobuf-4.21.9.dist-info只是包的元数据目录，旧版本3.17.3的实际代码仍存在于系统路径中，导致Colab加载了旧版本。
• 直接执行!pip install protobuf==4.21.1无效，是因为旧版本未被彻底卸载，且没有重启运行时让新包生效。
• 克隆GitHub的protobuf包到/content路径无法解决问题，因为Colab默认优先加载系统路径下的包。

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