如何通过Github Actions测试Rails生产环境服务器能否正常启动

有两种常用实现方式，可根据你的验证精度要求选择：

方案1：使用timeout命令限时运行（最简实现，符合你“运行数秒不抛出异常即成功”的需求） #

Github Action默认使用Ubuntu runner，系统自带timeout工具，会在指定时长后自动终止运行中的进程，无需手动处理服务驻留问题。
调整后的工作流配置如下：

- name: RSpec
  run: |
    bundle exec rspec ./spec
- name: Verify Rails production boot
  run: timeout 10s bundle exec rails s -e production

逻辑说明： #

• 命令中的10s可自行调整为你需要的验证时长，比如5s/15s均可
• 若Rails启动过程中抛出异常，进程会提前退出并返回非0状态码，Action直接判定该步骤失败
• 若10秒内无异常，timeout会主动终止Rails服务进程，返回0状态码，Action判定步骤成功

方案2：后台启动+健康检查（更严谨，可验证服务实际可响应请求） #

如果需要不仅验证启动无报错，还要确认服务确实能正常处理请求，可以用后台启动+端口检测的逻辑，配置如下：

- name: RSpec
  run: |
    bundle exec rspec ./spec
# 提前准备生产启动依赖的前置操作，避免启动报错
- name: Precompile assets for production
  run: bundle exec rails assets:precompile RAILS_ENV=production
  env:
    SECRET_KEY_BASE: ${{ secrets.SECRET_KEY_BASE }}
- name: Verify Rails production boot
  env:
    SECRET_KEY_BASE: ${{ secrets.SECRET_KEY_BASE }}
    RAILS_LOG_TO_STDOUT: true
  run: |
    # 后台启动Rails服务，记录进程ID
    bundle exec rails s -e production -p 3000 &
    SERVER_PID=$!
    # 等待启动完成
    sleep 10
    # 检测服务是否可正常访问
    if curl -s -o /dev/null -w "%{http_code}" http://localhost:3000 | grep -q "200\|301\|302"; then
      echo "✅ Rails production server started successfully"
      kill $SERVER_PID
      exit 0
    else
      echo "❌ Rails production server failed to start"
      kill $SERVER_PID
      exit 1
    fi

注意事项： #

• 生产模式启动Rails需要提前配置SECRET_KEY_BASE环境变量，你可以将其存到仓库的Secrets中再在工作流里引用
• 如果你的服务有专门的健康检查接口，可将curl请求地址换成/health之类的专用路径，验证逻辑更准确

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