Capistrano部署Rails项目时Gemfile.lock指定Bundler版本缺失报错
故障场景:
把Ruby on Rails Web应用部署到staging服务器时,Capistrano流程在依赖安装环节反复中断:执行bundle install时,系统识别到发布目录下的Gemfile.lock要求1.16.1版本的Bundler,但rubygems无法检索到对应版本,直接抛出Gem::GemNotFoundException。
已确认的基础信息:
- 服务器为Ubuntu 20.04,通过RVM管理Ruby 2.7.0运行环境
- 已在服务器本地安装过Bundler,部署流程仍报相同错误
- 部署流程可正常生成版本发布目录,但因依赖安装失败,不会生成指向当前上线版本的
current软链,整体流程终止
三个核心问题的对应解答
是否需要调整服务器上Bundler的默认版本
完全不需要改动系统全局或者RVM层的默认Bundler版本。
这个报错的核心原因不是默认版本不匹配,是RVM按Ruby版本隔离gems存储路径的机制,导致你之前手动安装的Bundler,根本没有落在Capistrano执行命令时激活的Ruby 2.7.0对应的gems目录下。你只需要切到部署使用的Ruby 2.7.0环境,单独安装Gemfile.lock要求的1.16.1版本Bundler即可,不需要改动其他环境的默认配置。
首次在新staging服务器部署是否遗漏必要的服务端配置
对照以下高频遗漏项逐一校验即可:
- 确认
capistrano-rvm插件配置和服务器实际的RVM安装路径完全匹配,避免Capistrano执行非交互式命令时,加载到系统自带的默认Ruby,而非RVM管理的2.7.0环境 - 确认部署使用的系统用户,对RVM对应Ruby 2.7.0版本的gems存储目录有读写权限,避免手动安装Bundler时权限不足,实际把文件写入了其他用户的路径下
- 确认服务器配置的rubygems源可正常访问,没有因为网络代理、源替换问题导致无法检索到1.16.1版本的Bundler
- 确认部署用户的Shell配置和RVM加载逻辑匹配,避免非交互式Shell执行时,RVM没有自动加载目标Ruby环境,导致命令路径错位
Bundler是否需要安装到特定路径才能被Capistrano正常识别
Bundler不需要安装到系统全局的特殊路径下,但必须和Capistrano执行bundle命令时激活的Ruby环境的gems路径完全对齐。
RVM是按Ruby版本隔离所有gem存储路径的,就算你在系统全局路径下安装了1.16.1版本的Bundler,只要Capistrano执行bundle install时加载的Ruby 2.7.0环境下的gems目录没有这个版本,就会触发找不到对应版本的报错。
可以通过两步快速校验路径是否匹配:
- SSH登录服务器,激活部署用的Ruby 2.7.0环境,执行
gem list bundler确认列表里存在1.16.1版本 - 执行
which bundle,确认返回的可执行文件路径在RVM对应的Ruby 2.7.0版本目录下,无路径错位即可
优化配置参考:如果手动安装后仍偶发路径错位问题,可在
deploy.rb中增加前置任务,在执行bundler:install前自动安装要求版本的Bundler,不需要改动服务器全局配置:before 'bundler:install' do on roles(:app) do execute 'gem install bundler -v 1.16.1 --no-document' end end
内容的提问来源于stack exchange,提问作者melmzilla

