GCloud App Engine部署Rails报错缺失railties(Gemfile已声明)

该报错核心原因是部署环境执行bundle exec时，当前bundle上下文无法找到已声明的gem，和本地Gemfile的配置本身无关，按以下步骤逐一排查修复即可：

排查步骤 #

• 确认Gemfile.lock未被忽略且已同步更新
  检查项目根目录下的.gitignore和.gcloudignore文件，确保没有将Gemfile.lock加入忽略规则。本地每次修改Gemfile后，必须先在项目根目录执行bundle install更新锁文件，再提交代码部署。GAE Ruby运行时不会主动更新锁文件，锁文件缺失、锁文件与Gemfile内容不匹配都会直接导致依赖安装异常。
• 修复锁文件的跨平台兼容问题
  本地开发环境多为macOS/Windows系统，而GAE柔性环境运行在Linux x86_64平台，本地生成的锁文件如果没有加入Linux平台支持，部署时会跳过对应平台的gem安装，触发缺失报错。本地执行以下命令添加Linux平台支持：

  bundle lock --add-platform x86_64-linux
  

  执行完成后提交更新后的Gemfile.lock即可。
• 对齐bundler版本
  从报错日志可以看到，GAE Ruby 2.7运行时预装的bundler版本为2.1.4，如果你本地使用2.2及以上版本的bundler生成锁文件，会存在格式兼容问题，导致部署时依赖加载异常。本地执行以下命令安装对齐版本的bundler，重新生成锁文件：

  gem install bundler -v 2.1.4
  bundle _2.1.4_ install
  

  提交更新后的锁文件后重新部署。
• 优化Gemfile的分组配置
  你当前的Gemfile同时声明了sqlite3和pg两个数据库驱动，建议按环境分组，避免生产环境安装不必要的依赖产生冲突，修改示例如下：

  # 开发、测试环境用sqlite3
  group :development, :test do
    gem "sqlite3", "~> 1.4"
  end
  
  # 生产环境用pg
  group :production do
    gem "pg"
  end
  

  修改完成后重新执行bundle install更新锁文件再提交。
• 验证启动配置
  你当前的entrypoint配置bundle exec rails server Puma -p $PORT写法本身没有问题，不需要替换为rackup启动。如果需要进一步定位问题，可以在部署时添加--verbosity=debug参数，查看构建阶段的bundle安装日志，确认railties、rack等gem是否被正确安装。

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