AWS Beanstalk部署Ruby on Rails报checkforraketask.rb rake加载错误

问题基础信息 #

• 环境版本：Ruby 2.7.6、Rails 6.0.3.7
• 现象：应用本地运行正常，可正常部署至Heroku，部署到AWS Beanstalk时触发checkforraketask.rb脚本报错，提示无法加载rake组件；已在Gemfile中声明rake依赖，问题仍复现
• 触发时机：Beanstalk执行数据库迁移前置检测命令bundle exec /opt/elasticbeanstalk/config/private/checkforraketask.rb db:migrate时抛出LoadError
• 核心报错日志：

/opt/elasticbeanstalk/config/private/checkforraketask.rb:16:in `require': cannot load such file -- rake (LoadError)
    from /opt/elasticbeanstalk/config/private/checkforraketask.rb:16:in `<top (required)>'
...
2022/06/29 18:30:22.208819 [INFO] No db:migrate task in Rakefile, skipping db:migrate.

解决步骤（按优先级排序） #

• 检查Gemfile的rake依赖分组
  绝大多数该类报错都是因为rake被写在了development或test分组下，Beanstalk部署默认执行bundle install --without development test，生产环境不会安装这两个分组下的gem。直接把rake的声明移到Gemfile全局作用域，不要套分组块：

  # 正确写法，放在所有group块外
  gem 'rake', '~> 13.0'
  

  修改后本地执行bundle install更新Gemfile.lock，提交代码后重新部署。
• 修正Bundler执行配置
  Amazon Linux 2版本的Beanstalk Ruby平台存在已知的bundle配置权限问题，webapp用户执行bundle命令时会读取到错误的依赖路径配置。直接在项目根目录新建.ebextensions/01_fix_bundle.config配置文件，写入以下内容，部署时强制重置bundle配置：

  commands:
    reset_bundle_config:
      command: |
        su webapp -c 'bundle config set --local path vendor/bundle'
        su webapp -c 'bundle config set --local without "development test"'
        su webapp -c 'bundle install'
  

• 清理环境旧缓存
  多次部署失败会让Beanstalk实例缓存损坏的依赖包，此时哪怕Gemfile配置正确也会出现加载错误。直接在Beanstalk控制台选中对应环境，点击「操作」-「重建环境」，完全清空实例上的旧缓存后重新拉取代码部署即可。
• 校验Rakefile有效性
  日志中出现No db:migrate task in Rakefile提示，需要确认项目根目录的Rakefile没有被.gitignore忽略、已经提交到代码仓库，且文件内正确加载了Rails的rake任务：

  # Rakefile必备内容
  require_relative "config/application"
  Rails.application.load_tasks
  

  Rakefile缺失或任务加载逻辑错误，也会导致rake加载流程异常。
• 对齐Ruby版本
  检查项目根目录.ruby-version声明的版本号，和Beanstalk平台配置的Ruby版本完全一致（当前场景为2.7.6），避免rbenv切换Ruby版本时，gem安装路径和执行路径不匹配，导致找不到已安装的rake。

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