如何在AWS Lambda环境下完成Laravel应用到RDS PostgreSQL的数据库迁移

你遇到的SQLSTATE[42P01]: Undefined table错误确实是未执行数据库迁移导致的，AWS Lambda运行环境默认不会自动触发Laravel迁移，以下是具体的解决方法：

Bref原生支持远程调用Laravel Artisan命令，无需登录服务器即可执行迁移：

• 本地配置好AWS访问凭证后，在项目根目录执行以下命令：
  serverless bref:cli --args="migrate --force"
  命令中的--force参数为必填项，Laravel在生产环境默认会弹出迁移确认提示，Lambda不支持交互输入，不加该参数会直接执行失败。
• 如果你本地可以通过SSH隧道或白名单方式直接访问RDS实例，也可以本地配置对应环境的数据库连接参数后直接执行：
  php artisan migrate --force

如果需要避免每次部署手动执行迁移，可以选择以下两种自动化实现方案：

• 方案1：Serverless部署钩子自动执行
  在serverless.yml中添加postdeploy部署后钩子，每次部署完成自动触发迁移：

  plugins:
    - ./vendor/bref/bref
  custom:
    scripts:
      postdeploy:
        - serverless bref:cli --args="migrate --force"
  

  配置完成后，每次执行serverless deploy结束后会自动运行迁移命令。

  注意：如果涉及表结构修改、大表迁移等耗时操作，建议避开业务高峰时段部署，避免锁表影响线上业务。

• 方案2：独立迁移Lambda函数（生产级安全方案）
  单独创建一个专属迁移的Lambda函数，配置最长15分钟的超时时间，和业务Web/队列函数完全隔离，避免业务代码意外触发迁移。
  你可以将迁移执行步骤加入CI/CD流水线：
  1. 流水线先完成业务代码打包、普通Lambda函数部署
  2. 调用独立迁移Lambda执行迁移命令
  3. 迁移校验成功后再切流量到新版本，迁移失败则直接触发版本回滚

执行迁移前请确认以下配置已经完成，避免出现连接失败问题：

• Lambda所在VPC、安全组出方向允许访问RDS实例的5432端口
• RDS实例的安全组入方向已放通Lambda所在安全组的5432端口访问权限
• Lambda的执行角色已配置VPC访问相关权限

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