AWS Linux 2上Elastic Beanstalk部署Laravel连接Postgres密码认证失败

第一步：验证数据库账号密码本身有效性 #

• 若使用AWS RDS托管Postgres，先登录RDS控制台，确认创建实例时设置的主用户名、密码、数据库名称，和Laravel配置的参数完全一致
• 不要直接修改Elastic Beanstalk部署目录下的.env文件，Beanstalk每次部署都会覆盖该文件，正确的配置入口是Elastic Beanstalk控制台「配置」-「软件」-「环境属性」
• 登录Beanstalk关联的EC2实例，执行cd /var/app/current && php artisan tinker，输入env('DB_PASSWORD')打印当前加载的数据库密码，确认无拼写错误、多余空格、特殊字符转义异常问题
• 若为自建Postgres，直接登录数据库服务器执行sudo -u postgres psql，输入ALTER USER postgres PASSWORD '你的新密码';重置密码后再测试连接

第二步：排查Postgres访问权限配置 #

• 若使用AWS RDS Postgres：
  • 需从本地连接的话要确认RDS已开启「公开访问」选项
  • 确认RDS安全组入站规则已开放5432端口，允许你本地IP、Beanstalk EC2实例的安全组访问；如果RDS部署在私有子网，本地无法直接连接，需要通过跳板机访问
• 若为自建Postgres：
  • 检查pg_hba.conf文件，确认你连接的来源IP对应的认证方式为md5或scram-sha-256，不是peer或ident
  • 检查postgresql.conf的listen_addresses配置，确认值为'*'或对应业务网卡地址，而非仅监听127.0.0.1
  • 配置修改后需执行sudo systemctl restart postgresql生效

第三步：排查Laravel配置问题 #

• 确认config/database.php中pgsql相关配置是读取DB_USERNAME、DB_PASSWORD等环境变量，没有硬编码的账号密码覆盖配置
• 到应用部署目录执行cd /var/app/current && php artisan config:clear清除配置缓存，避免旧缓存的错误配置生效
• 确认DB_HOST填写的是正确的RDS端点或数据库服务器地址，无拼写错误，端口默认5432不要误填

第四步：本地直连测试定位问题 #

• 本地安装psql客户端后执行命令直连测试：psql -h 你的数据库地址 -U postgres -d 你的数据库名，输入密码后如果仍报认证错误，说明问题和Laravel无关，优先排查数据库本身的账号密码、访问权限配置

只要psql直连仍报密码错误，100%是账号密码不匹配、账号不存在、pg_hba.conf/安全组配置错误导致，优先排查上述几点

常见特殊场景问题 #

• 很多人创建RDS实例时自定义了主用户名，配置Laravel参数时默认写postgres就会报错，需要确认和RDS创建时的主用户名完全一致
• 如果密码包含$、#、!之类的特殊字符，在Elastic Beanstalk环境变量中配置不需要加引号，写在.env文件中则需要用单引号包裹避免被系统解析
• 确认没有开启RDS的IAM数据库认证，开启该功能后普通密码认证默认不生效，需要用IAM生成的动态token连接

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