AWS CodeBuild无法与RDS实例交互，该如何排查问题？

我来帮你梳理下排查这个问题的关键步骤，按从易到难、从基础到深入的顺序来：

1. 先确认网络连通性（最基础也最容易出问题） #

因为两者都在默认VPC里，重点检查安全组和路由配置：

• 检查RDS安全组的入站规则：是否允许CodeBuild所在安全组（或者CodeBuild环境的IP范围）访问PostgreSQL默认端口5432；
• 检查CodeBuild安全组的出站规则：是否允许向RDS的安全组/IP发起5432端口的请求；
• 验证连通性：在buildspec.yml的migrate步骤之前，加一段测试命令，比如：

  nc -zv <你的RDS端点> 5432
  # 或者用psql客户端测试连接
  psql -h <RDS端点> -U <DB用户名> -d <DB名称> -c "SELECT 1;"
  

  如果这一步失败，那问题肯定出在网络上。

2. 验证数据库凭据与Laravel配置 #

Laravel的migrate依赖正确的数据库配置，别忽略这些细节：

• 确认CodeBuild环境中能正确读取到Laravel的数据库配置：检查.env文件是否正确生成（比如buildspec里有没有从.env.example复制并填充环境变量），或者CodeBuild的环境变量有没有正确传递DB_HOST、DB_PORT、DB_DATABASE、DB_USERNAME、DB_PASSWORD这些参数；
• 检查RDS数据库用户的权限：这个用户有没有CREATE TABLE、ALTER TABLE、DROP TABLE等执行迁移所需的权限？可以手动用这个用户连接RDS，尝试创建一个测试表验证权限；
• 确认目标数据库已存在：Laravel的migrate不会自动创建数据库，你需要提前在RDS控制台手动创建好DB_DATABASE指定的数据库。

3. 检查CodeBuild环境的依赖支持 #

CodeBuild的镜像可能缺少Laravel连接PostgreSQL所需的依赖：

• 确认镜像中安装了PostgreSQL客户端：比如用Ubuntu镜像的话，需要在buildspec的install阶段执行apt-get install -y postgresql-client；
• 确认PHP环境安装了pgsql扩展：Laravel依赖PHP的pgsql扩展来连接PostgreSQL，检查buildspec里有没有安装这个扩展（比如Ubuntu下是apt-get install -y php-pgsql，根据你用的PHP版本调整）；
• 避免配置缓存干扰：如果buildspec里执行了php artisan config:cache，要确保是在配置正确之后执行，或者在migrate之前先执行php artisan config:clear，防止缓存了错误的配置。

4. 深挖错误日志（定位具体问题的关键） #

不要只看表面的报错，要获取更详细的日志：

• 在migrate命令中增加详细输出：把./artisan migrate --force改成./artisan migrate --force -v，这样能看到具体的SQL执行错误或者连接错误信息；
• 查看CodeBuild的完整日志：CodeBuild会记录整个构建过程的所有输出，仔细找有没有关于数据库连接、权限、SQL语法的具体报错，比如“could not connect to server”（网络/配置问题）、“permission denied”（权限问题）、“relation does not exist”（配置或迁移文件问题）。

5. 检查RDS实例本身的状态 #

最后确认RDS没有自身的问题：

• 检查RDS实例状态：在AWS控制台看RDS是不是处于可用状态，有没有正在维护或者停机；
• 检查RDS参数组：有没有设置限制连接的参数（比如max_connections过低），或者启用了阻止连接的安全配置；
• 确认RDS的公开访问配置：虽然你说RDS是公开访问，但要确认控制台里“Publicly accessible”选项确实是开启的，并且实例有公网IP。

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