Docker构建Rails镜像运行报错：Bundler::GemNotFound问题求助

1. 先查Dockerfile的bundle执行流程 #

• 确保Dockerfile里先把Gemfile和Gemfile.lock（本地存在的话）复制到容器工作目录，再执行bundle install。如果本地删了Gemfile.lock，容器内执行bundle install时若遇网络或源问题，会导致无法生成新的lock文件。示例修正后的Dockerfile片段：

  WORKDIR /app
  # 先传递Gemfile相关文件，利用Docker缓存优化构建
  COPY Gemfile* ./
  # 安装依赖，可按需排除开发/测试环境依赖
  RUN bundle install --without development test
  # 最后复制整个应用代码
  COPY . .
  

• 检查是否设置了BUNDLE_PATH环境变量，若将gem安装到非标准路径，运行时Bundler会找不到依赖。

2. 解决本地bundle install不生成lock文件的问题 #

• 本地删除Gemfile.lock后执行bundle install无新文件生成，说明本地环境存在问题，先在本地排查：
  • 核对Ruby版本：查看Gemfile开头的ruby 'x.x.x'配置，与本地ruby -v输出的版本是否一致，版本不匹配会直接导致bundle安装失败。
  • 更换Gem源：默认rubygems.org可能访问受限，换成国内源（如https://gems.ruby-china.com/），执行gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/后，再重新运行bundle install。
  • 查看详细报错：执行bundle install --verbose，可定位具体是哪个gem安装失败，导致lock文件无法生成。

3. Docker构建阶段的网络问题 #

• 构建镜像时容器网络不通，bundle无法下载gem，自然无法生成lock文件，运行时就会缺失依赖：
  • 构建时添加--network host参数，让容器使用宿主机网络：docker build --network host -t your-rails-image .
  • 在Dockerfile中提前替换Gem源，避免构建时网络卡顿：

    RUN gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/
    RUN bundle config mirror.https://rubygems.org https://gems.ruby-china.com
    

4. 运行容器时的挂载冲突 #

• 若运行容器时用-v将本地的/app目录挂载到容器内，会直接覆盖容器内已安装的gem和生成的Gemfile.lock，导致运行时找不到依赖。解决办法：
  • 不要挂载整个/app目录，仅挂载需要修改的部分（如config文件夹）；或者本地先执行bundle install生成正确的Gemfile.lock，再挂载目录。

5. 核对Gemfile中的依赖配置 #

• 确认Gemfile中确实包含mysql2、rails等依赖，例如：

  gem 'rails', '~> 7.0.0'
  gem 'mysql2', '~> 0.5.5'
  

  若有缺失，补充后重新执行bundle install并构建镜像。

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