多版本AWS CLI与固定Boto版本致Jenkins实例中AWS CLI无法运行

我维护老Jenkins实例时也踩过这个一模一样的坑——手动固定Boto版本后，AWS CLI直接报错无法运行，核心原因就是AWS CLI依赖特定版本的Boto系列包（boto、boto3、botocore），强行锁版本导致依赖链断裂。下面给你几个实操性强的解决办法：

方法1：卸载重装匹配版本的依赖（全局环境修复） #

如果你的Jenkins只能用全局Python环境，先清掉冲突包再装兼容版本：

• 卸载所有相关依赖：

  pip2 uninstall -y awscli boto boto3 botocore
  

  （用pip2是因为你的环境是Python2.7，避免和Python3的pip混淆）
• 安装兼容的版本组合：Python2.7最后支持的AWS CLI版本是1.18.223，它和Boto2的2.49.0完美兼容，执行：

  pip2 install awscli==1.18.223 boto==2.49.0
  

  装完后跑aws --version验证，应该就能正常使用了。

方法2：用虚拟环境隔离依赖（更推荐，避免后续冲突） #

全局环境改依赖容易影响其他任务，用虚拟环境把AWS CLI的依赖单独隔离是更稳妥的方案：

• 先安装虚拟环境工具：

  pip2 install virtualenv
  

• 创建专属虚拟环境：

  virtualenv /opt/aws-cli-venv
  

• 激活环境并安装指定版本依赖：

  source /opt/aws-cli-venv/bin/activate
  pip install awscli==1.18.223 boto==2.49.0
  deactivate
  

• 之后在Jenkins构建任务里，不要直接用aws命令，改用虚拟环境内的路径，比如：

  /opt/aws-cli-venv/bin/aws s3 ls
  

  这样完全不会干扰全局Python依赖。

方法3：排查Jenkins构建脚本的依赖逻辑 #

有时候问题出在构建脚本里——比如脚本强制安装特定Boto版本，却没考虑AWS CLI的兼容性：

• 先在Jenkins任务里加一步，打印当前依赖版本确认冲突：

  pip2 freeze | grep -E 'awscli|boto|botocore'
  

• 检查脚本中的pip install命令，确保安装Boto的操作要么在虚拟环境内执行，要么和AWS CLI版本匹配。

额外提一句：Python2.7已经停止维护好几年了，如果有条件，建议把Jenkins实例的Python环境升级到3.6+，这样可以用更新的AWS CLI和Boto版本，从根源上避免这类老版本兼容问题。

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