无法将Rails API部署到AWS Elastic Beanstalk Ruby 3.0平台的技术求助

一、为什么实例中没有PostgreSQL？ #

Elastic Beanstalk的Ruby平台（Amazon Linux 2）默认仅预装Ruby运行时、Web服务器（Puma/Nginx）等基础组件，不会自带PostgreSQL数据库服务。EB作为应用托管平台，数据库需通过以下两种方式提供：

• 关联AWS RDS PostgreSQL实例（推荐，符合托管平台最佳实践）
• 手动在EB实例上安装PostgreSQL（仅适合临时测试，实例重启/扩容会丢失数据）

二、解决rake db:migrate连接失败问题 #

1. 关联RDS PostgreSQL实例（推荐方案） #

• 进入Elastic Beanstalk控制台，找到目标环境 → 配置 → 数据库 → 修改
• 选择PostgreSQL作为引擎，配置实例规格、用户名、密码等，保存后EB会自动将数据库连接信息注入环境变量（RDS_HOSTNAME、RDS_PORT、RDS_DB_NAME、RDS_USERNAME、RDS_PASSWORD）
• 在Rails的config/database.yml中读取这些环境变量，示例配置：

production:
  adapter: postgresql
  encoding: unicode
  host: <%= ENV['RDS_HOSTNAME'] %>
  port: <%= ENV['RDS_PORT'] %>
  database: <%= ENV['RDS_DB_NAME'] %>
  username: <%= ENV['RDS_USERNAME'] %>
  password: <%= ENV['RDS_PASSWORD'] %>
  pool: <%= ENV.fetch("RAILS_MAX_THREADS") { 5 } %>

• 重新执行eb deploy，此时rake db:migrate会连接RDS上的PostgreSQL服务，不会再出现套接字不存在的错误

2. 手动在EB实例安装PostgreSQL（临时测试用） #

通过.ebextensions脚本实现自动安装：

• 在项目根目录创建.ebextensions/postgres.config文件，内容如下：

packages:
  yum:
    postgresql13: []
    postgresql13-server: []
    postgresql13-devel: []

commands:
  01_init_db:
    command: "postgresql-setup initdb"
  02_start_postgres:
    command: "systemctl start postgresql"
    ignoreErrors: true
  03_enable_postgres:
    command: "systemctl enable postgresql"
    ignoreErrors: true
  04_create_user:
    command: "sudo -u postgres createuser -s webapp"
    ignoreErrors: true
  05_create_db:
    command: "sudo -u postgres createdb your_app_production"
    ignoreErrors: true

• 修改config/database.yml的production配置为本地套接字连接：

production:
  adapter: postgresql
  encoding: unicode
  database: your_app_production
  username: webapp
  pool: <%= ENV.fetch("RAILS_MAX_THREADS") { 5 } %>

• 执行eb deploy，脚本会自动完成PostgreSQL的安装与配置

三、解决Bundler权限错误问题 #

SSH以webapp用户执行时无法写入路径安装public_suffix，是因为Bundler默认尝试写入系统Ruby的gem目录（权限受限），解决方法：

• 在项目根目录创建.bundle/config文件，内容：

---
BUNDLE_PATH: "vendor/bundle"
BUNDLE_DISABLE_SHARED_GEMS: "true"

• 此配置会让Bundler将gem安装到项目目录的vendor/bundle下，webapp用户拥有该目录的读写权限
• 也可直接在执行命令时指定路径：bundle install --path vendor/bundle

四、为什么两次错误不一致？ #

• eb deploy执行时，EB引擎以root或eb-user身份运行部署流程，此时环境变量由EB注入（若未关联RDS，数据库配置指向本地套接字，但本地未安装PostgreSQL，因此报套接字不存在错误）
• 手动SSH以webapp用户执行时，环境变量缺失EB的配置，且webapp用户无系统gem目录的写入权限，因此报Bundler权限错误

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