将标准Rails API应用部署到Elastic Beanstalk时出现部署错误

首先先把你提供的部署日志整理出来（看起来日志被截断了，但从现有内容能看到当前环境使用的Ruby版本是2.4.3）：

++ export RUBY_ROOT=/opt/rubies/ruby-2.4.3
++ RUBY_ROOT=/opt/rubies/ruby-2.4.3
++ export RUBYOPT=
++ RUBYOPT=
++ export PATH=/opt/rubies/ruby-2.4.3/bin:/opt/elasticbeanstalk/lib/ruby/bin:/usr/local/sbin:/usr/local/bin:/usr/bin:/usr/sbin:/sbin:/bin
++ PATH=/opt/rubies/ruby-2.4.3/bin:/opt/elasticbeanstalk/lib/ruby/bin:/usr/local/sbin:/usr/local/bin:/usr/bin:/usr/sbin:/sbin:/bin
+++ /opt/rubies/ruby-2.4.3/bin/ru...

结合Elastic Beanstalk部署Rails API的常见踩坑点，给你几个具体的排查和解决方向：

1. 先确认Ruby版本是否匹配 #

• 检查你Rails项目Gemfile顶部的Ruby版本声明，比如ruby '2.7.4'，如果和EB环境用的2.4.3不一致，大概率会导致依赖安装失败。
• 解决办法：要么修改Gemfile里的Ruby版本和EB环境保持一致，要么登录EB控制台，进入对应环境→配置→软件→修改Ruby版本为项目要求的版本。

2. 排查Bundle安装失败的可能 #

日志截断的部分大概率是bundle install的执行过程，常见问题有这几种：

• 私有Gem源无法访问：如果你的Gemfile里用到了私有Gem源，需要通过.ebextensions配置文件添加SSH密钥，或者在EB环境变量里设置BUNDLE_GEMFILE等相关参数。
• 系统依赖缺失：像Nokogiri、Pg这类Gem需要对应的系统库支持，你可以在项目根目录创建.ebextensions/install_deps.yml，添加需要安装的系统包：

  packages:
    yum:
      postgresql-devel: []
      libxml2-devel: []
      libxslt-devel: []
  

3. 检查数据库配置是否到位 #

Rails API需要数据库配置，但EB不会自动生成database.yml，你可以这么处理：

• 在项目根目录创建.ebextensions/database_config.yml，内容如下：

  files:
    "/opt/elasticbeanstalk/hooks/appdeploy/pre/11_set_up_database.sh":
      mode: "000755"
      owner: root
      group: root
      content: |
        #!/usr/bin/env bash
        EB_APP_STAGING_DIR=$(/opt/elasticbeanstalk/bin/get-config container -k app_staging_dir)
        # 假设你有database.yml.example模板文件
        cp $EB_APP_STAGING_DIR/config/database.yml.example $EB_APP_STAGING_DIR/config/database.yml
        # 替换环境变量对应的数据库参数
        sed -i "s/<%= ENV['DB_HOST'] %>/$(/opt/elasticbeanstalk/bin/get-config environment -k DB_HOST)/" $EB_APP_STAGING_DIR/config/database.yml
        sed -i "s/<%= ENV['DB_USER'] %>/$(/opt/elasticbeanstalk/bin/get-config environment -k DB_USER)/" $EB_APP_STAGING_DIR/config/database.yml
        sed -i "s/<%= ENV['DB_PASSWORD'] %>/$(/opt/elasticbeanstalk/bin/get-config environment -k DB_PASSWORD)/" $EB_APP_STAGING_DIR/config/database.yml
  

  然后在EB环境的配置页面添加对应的数据库环境变量（DB_HOST、DB_USER、DB_PASSWORD等）。

4. 处理资产预编译问题 #

虽然是API项目，但部分Rails版本还是会默认执行资产预编译，如果你不需要这个步骤，可以：

• 在config/application.rb里添加config.assets.enabled = false；
• 或者在EB环境变量里设置RAILS_SKIP_ASSET_COMPILATION=true。

5. 获取完整部署日志定位问题 #

目前的日志被截断了，建议你登录EB控制台，进入对应环境→日志→请求日志→下载完整日志，这样能看到具体的错误节点，比如是Gem安装报错、数据库迁移失败还是其他环节出了问题。

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