Bundler版本显式存在但实际版本不符无法卸载的成因与修复方案

异常成因 #

该问题是rbenv管理的Ruby环境下典型的Bundler可执行文件匹配异常，核心原因如下：

• 命令环境不匹配：你当前调用的bundler可执行文件不属于rbenv 2.7.4版本的管理范围，要么来自系统全局预装的Bundler，要么来自其他Ruby版本的gem安装路径，该路径在系统PATH中的排序早于rbenv 2.7.4的bin路径，因此调用时优先命中了2.1.4版本。而gem命令已经被rbenv切换到了2.7.4版本对应的环境，所以gem list只会查询当前Ruby版本下的gem包，自然找不到不在当前安装路径下的2.1.4版本，卸载时就会提示对应Gem未安装。
• rbenv shim缓存失效：如果之前更新过Bundler版本但没有执行rbenv rehash刷新可执行文件垫片缓存，rbenv的shim仍然会指向旧版本的Bundler路径，导致版本不匹配。
• 项目锁文件触发版本强制匹配：如果你是在Ruby项目目录下执行的命令，Gemfile.lock末尾BUNDLED WITH字段指定的版本为2.1.4，Rubygems内置的BundlerVersionFinder机制会优先尝试调用锁文件指定的版本，也会出现版本显示和已安装版本不一致的情况。

修复方案 #

按照以下步骤顺序操作即可解决：

1. 先确认当前bundler的实际路径，执行命令：

which bundler

如果输出路径不是/Users/me/.rbenv/versions/2.7.4/bin/bundler，即可确认是PATH优先级问题。
2. 刷新rbenv的可执行文件缓存：

rbenv rehash

执行后再次运行bundler --version验证版本是否正常。
3. 如果仍未解决，强制将2.2.21设为当前Ruby版本的默认Bundler：

gem install bundler -v 2.2.21 --default
rbenv rehash

4. 如果是项目场景下的问题，可选择两种方案：
   • 更新项目锁文件的Bundler版本：bundle update --bundler
   • 安装匹配锁文件的2.1.4版本：gem install bundler -v 2.1.4
5. 若上述步骤无效，调整shell配置的PATH优先级，在~/.zshrc、~/.bashrc等配置文件中添加以下内容，确保rbenv路径优先加载：

export PATH="$HOME/.rbenv/shims:$PATH"

添加后执行source ~/.zshrc（根据你使用的shell调整配置文件名）重载配置即可。

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