使用AWS Elastic Beanstalk CLI部署Rails应用时Gem依赖安装失败求助

第一步：定位具体错误 #

先从eb-engine.log里抓关键报错，重点排查：

• 是否存在Gem版本冲突提示
• 是否缺少系统级编译依赖（比如Nokogiri需要libxml2、Puma需要gcc）
• 私有Gem源的权限或访问问题

用EB CLI快速拉取引擎日志：

eb logs --engine

第二步：针对性修复方案 #

1. 补充系统依赖包 #

Ruby Gem常需要系统库支持，EB默认环境可能未预装。在项目根目录创建.ebextensions/packages.config，添加所需依赖：

packages:
  yum:
    gcc-c++: []
    make: []
    libxml2-devel: []
    libxslt-devel: []
    postgresql-devel: [] # 用PostgreSQL时添加
    mysql-devel: [] # 用MySQL时添加

2. 锁定Gem版本并清理缓存 #

• 在Gemfile里明确指定所有依赖的具体版本，避免自动升级引发冲突
• 本地执行bundle install生成最新Gemfile.lock，务必提交该文件
• 禁用EB的Gem缓存（若旧缓存导致版本冲突），创建.ebextensions/gem_cache.config：

option_settings:
  - namespace: aws:elasticbeanstalk:application:environment
    option_name: BUNDLE_DISABLE_SHARED_GEMS
    value: '1'

3. 匹配Ruby版本 #

确保EB环境的Ruby版本和本地开发环境一致：

• 项目根目录创建.ruby-version文件，写入你的Ruby版本（如3.2.2）
• 通过CLI设置环境Ruby版本：

eb config set aws:elasticbeanstalk:container:ruby:rubyversion 3.2.2

4. 私有Gem源配置（若使用） #

若依赖私有Gem，需配置EB环境的访问权限。创建.ebextensions/gem_credentials.config：

files:
  "/root/.gemrc":
    mode: "000644"
    owner: root
    group: root
    content: |
      ---
      :sources:
        - https://rubygems.org/
        - https://你的私有Gem源地址/
      :credentials:
        你的私有Gem源地址:
          username: 你的账号名
          password: 你的访问令牌/密码

注意：敏感信息建议用EB环境变量存储，不要硬编码，比如将密码替换为#{ENV['PRIVATE_GEM_PASSWORD']}，再到EB控制台设置对应环境变量

第三步：重新部署 #

提交所有新增配置文件和修改后的Gem相关文件，重新部署：

git add .
git commit -m "修复EB部署的Gem安装问题"
eb deploy

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