升级AWS RDS从MySQL5到MySQL8后，Elastic Beanstalk环境无法连接

1. 核对Elastic Beanstalk环境变量配置 #

• 登录EB控制台，进入配置 > 软件 > 环境属性，检查数据库连接相关变量（如DB_HOST、DB_PORT等）是否和本地.env文件里的新MySQL8实例信息完全一致，重点排查主机地址拼写、端口号（MySQL8默认3306，若修改过需对应）。
• 登录EB对应的EC2实例（通过SSH），执行printenv | grep DB_（假设变量前缀为DB_），验证环境变量是否正确生效。

2. 检查PHP版本与MySQL8的兼容性 #

• MySQL8默认使用caching_sha2_password认证插件，PHP 7.1及以上版本才支持该插件。若EB环境的PHP版本低于7.1，会直接导致数据库连接失败，进而引发应用启动异常。
• 查看EB环境PHP版本：控制台配置 > 软件板块，或在实例上执行php -v。若版本过低，可升级EB的PHP环境；临时 workaround 可修改MySQL8用户的认证插件：

  ALTER USER 'your_username'@'%' IDENTIFIED WITH mysql_native_password BY 'your_password';
  FLUSH PRIVILEGES;
  

3. 分析日志定位具体错误 #

不要只依赖ELB的健康提示，直接查看EB实例的详细日志：

• 在EB控制台日志 > 请求日志下载完整日志包，重点检查：
  • /var/log/php-fpm/www-error.log：PHP应用的错误日志，查找数据库连接相关报错（如认证失败、连接超时）。
  • /var/log/web.stdout.log：应用启动输出日志，查看框架（如Laravel、Symfony）是否抛出数据库连接异常。
  • /var/log/nginx/error.log：Nginx错误日志，确认后端服务无法响应的具体原因。

4. 手动验证EB实例到MySQL8的连通性 #

即使排除了安全组，也可手动测试确认：

• 在EB实例上安装MySQL客户端：

  # Amazon Linux 2
  sudo yum install mysql -y
  # Ubuntu
  sudo apt install mysql-client -y
  

• 执行连接命令：mysql -h new-mysql8-host -u your_username -p，输入密码后查看是否能成功登录。若失败，错误信息会直接指明问题（如认证错误、网络超时）。

5. 检查ELB健康检查配置 #

503错误可能是健康检查规则导致实例被标记为异常：

• 进入EB控制台配置 > 负载均衡器 > 健康检查，确认健康检查路径是否正确（如应用根路径/或专门的/health接口），若该路径返回非200状态码，ELB会标记实例为OutOfService。
• 调整健康检查的超时、间隔、阈值，若应用启动较慢，可适当延长超时时间（如从5秒调至10秒），给应用足够时间完成数据库连接初始化。

6. 确认MySQL8实例状态与参数配置 #

• 登录RDS控制台，检查MySQL8实例状态是否为可用，存储空间是否充足（避免因空间不足导致读写失败）。
• 查看实例关联的参数组，确认default_authentication_plugin配置：若为caching_sha2_password需确保PHP版本兼容；若为mysql_native_password则适配旧版PHP。

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