Bundle调用加载错误：Ruby项目自动化配置问题求助
2026-5-19
解决Ruby 2.3.x + Ubuntu下Bundle加载错误的方案
我之前在Ubuntu上折腾老版本Ruby的时候也碰到过类似的Bundle加载问题，给你几个具体的排查和解决步骤试试：
先确认Ruby与Bundler的环境匹配
有时候系统自带的Ruby和你手动安装的Ruby会出现路径冲突，导致Bundler找不到正确的Ruby环境。- 执行
which ruby和which bundle，检查两者的路径是否一致。比如Ruby在/usr/bin/ruby的话，Bundler也应该在/usr/bin/bundle才对；如果路径不同，说明Bundler可能装到了其他Ruby环境里。 - 再运行
gem env，查看输出里的GEM PATHS，确认Bundler是否安装在这个路径的gems目录下。
- 执行
安装与Ruby 2.3.x兼容的Bundler版本
新版本的Bundler（比如2.x及以上）已经不再支持Ruby 2.3.x了，这很可能是你报错的核心原因：- 先卸载所有已安装的Bundler版本：
gem uninstall bundler --all - 安装兼容的1.x版本：
gem install bundler -v 1.17.3（这个版本是经过验证和Ruby 2.3.x完美兼容的） - 之后用指定版本运行Bundle命令试试：
bundle _1.17.3_ install
- 先卸载所有已安装的Bundler版本：
更新Rubygems到适配的版本
你当前的Rubygems 2.3.0版本太老了，和新版Bundler（哪怕是1.x后期版本）可能存在兼容问题，建议更新到适配Ruby 2.3.x的最新Rubygems版本：- 执行
gem update --system 2.7.10，这个版本是Ruby 2.3.x能支持的最高Rubygems版本，不能再往上更新了，否则会出现不兼容问题。
- 执行
重置项目的Gemfile.lock文件
如果你的项目之前在其他环境（比如macOS或者更高版本的Ruby）下运行过，生成的Gemfile.lock可能包含当前环境不兼容的依赖信息：- 先备份原文件：
cp Gemfile.lock Gemfile.lock.bak - 删除原lock文件：
rm Gemfile.lock - 重新执行
bundle install，让Bundler生成适配当前Ubuntu + Ruby 2.3.x环境的lock文件。
- 先备份原文件：
规避系统权限问题
有时候系统级的gem目录会存在读写权限限制，导致Bundler无法加载依赖：- 可以尝试把gem安装到项目本地目录：
bundle install --path vendor/bundle，这样所有依赖都会存放在项目根目录的vendor/bundle下，避开系统权限的问题。
- 可以尝试把gem安装到项目本地目录：
如果按照上面的步骤操作后还是报错，建议把具体的加载错误信息贴出来，这样能更精准地定位问题～
内容的提问来源于stack exchange，提问作者DevLuke
相关产品推荐
相关产品推荐
