升级AWS RDS MySQL5.7至8后CakePHP2.x连接报错求助

核心原因分析 #

这个错误主要源于两个兼容性问题：

1. MySQL 8默认启用caching_sha2_password认证插件，而旧版本PHP的PDO MySQL驱动不支持该插件，直接导致连接失败。
2. 数据库字符集与RDS参数组配置不一致，进一步加剧连接兼容性冲突。

分步解决方案 #

1. 切换数据库用户认证插件 #

登录RDS MySQL控制台，执行以下SQL将应用使用的数据库账号切换为旧版兼容的mysql_native_password插件：

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

注意：将your_username和your_password替换为实际数据库账号密码；%表示允许任意地址连接，若应用有固定IP，可替换为对应IP地址。

2. 统一数据库与RDS参数组字符集 #

虽然你已在RDS参数组设置utf8mb4，但现有数据库仍为utf8mb3，需执行SQL转换数据库字符集：

ALTER DATABASE your_database_name CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

同时确保RDS参数组的以下参数已正确设置并应用：

• character_set_server = utf8mb4
• collation_server = utf8mb4_unicode_ci
• default_authentication_plugin = mysql_native_password（避免新用户默认使用不兼容的认证插件）

3. 调整CakePHP数据库配置 #

修改app/Config/database.php，匹配RDS的字符集与认证方式，同时注意替换为实际RDS端点（不要用localhost）：

public $default = array(
    'datasource' => 'Database/Mysql',
    'persistent' => false,
    'host' => 'your_rds_endpoint',
    'login' => 'your_username',
    'password' => 'your_password',
    'database' => 'your_database_name',
    'prefix' => '',
    'encoding' => 'utf8mb4',
    'collation' => 'utf8mb4_unicode_ci',
    // 强制初始化连接字符集
    'flags' => array(
        PDO::MYSQL_ATTR_INIT_COMMAND => 'SET NAMES utf8mb4',
    ),
);

4. 恢复PHP配置一致性 #

将之前修改的php.ini配置改回匹配utf8mb4的设置，避免字符集冲突：

default_charset = "utf8mb4"
pdo_mysql.default_charset = utf8mb4

修改后重启PHP-FPM或Web服务器，确保配置生效。

验证步骤 #

1. 重新启动应用，检查是否仍存在2054错误。
2. 再次查询数据库字符集，确认与RDS参数组配置一致：

SELECT DEFAULT_CHARACTER_SET_NAME, DEFAULT_COLLATION_NAME
FROM INFORMATION_SCHEMA.SCHEMATA
WHERE SCHEMA_NAME = 'your_database_name';

预期结果应为utf8mb4和utf8mb4_unicode_ci。

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