MySQL错误码 2059 - 认证插件不支持。

错误信息

Error 2059

认证插件不支持。

你的PHP应用在使用PDO连接MySQL时遇到了认证插件不兼容的问题：

                    'pdo_code' => 'HY000',

                    'db_code' => 2059,

                    'db_error' => 'Authentication plugin not supported'

版本兼容性说明

此错误通常发生在MySQL 8.0及以上版本中，当客户端使用旧的认证方式（如mysql_native_password）连接时，而服务器期望使用新的认证插件（如caching_sha2_password）。

解决方案

升级客户端库到支持新认证插件的版本
修改MySQL用户使用旧的认证方式
在连接字符串中指定认证插件
更新PHP的MySQL扩展（mysqlnd）
检查MySQL服务器配置
使用兼容的连接选项

PHP连接配置示例

                    // 方法1：使用PDO选项指定认证插件

                    $options = [

                      PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES utf8mb4",

                      PDO::MYSQL_ATTR_SSL_VERIFY_SERVER_CERT => false,

                      // 对于某些版本可能需要指定认证插件

                      // PDO::MYSQL_ATTR_DIRECT_QUERY => true

                    ];

                    try {

                      $pdo = new PDO(

                        "mysql:host=localhost;dbname=test;charset=utf8mb4",

                        "username",

                        "password",

                        $options

                      );

                      $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

                    } catch (PDOException $e) {

                      echo "连接失败: " . $e->getMessage();

                    }

                    // 方法2：修改MySQL用户认证方式（需要在MySQL中执行）

                    -- 将用户认证方式改为mysql_native_password

                    ALTER USER 'username'@'localhost' IDENTIFIED WITH mysql_native_password BY 'password';

                    -- 或者修改默认认证插件（需要重启MySQL）

                    -- 在my.cnf中添加：default_authentication_plugin=mysql_native_password

认证流程演示

MySQL 8.0引入了新的认证机制，导致兼容性问题：

客户端 (旧版本)

尝试使用 mysql_native_password 认证

发送旧的认证握手协议...

MySQL服务器 (8.0+)

期望使用 caching_sha2_password 认证

拒绝旧的认证方式...

错误响应

返回错误：2059

提示：Authentication plugin not supported

版本兼容性

支持的客户端版本

PHP 7.4+ 与 mysqlnd 驱动
MySQL Connector/J 8.0+
MySQL Connector/NET 8.0+
MySQL Connector/C++ 8.0+
MySQL Connector/ODBC 8.0+

认证插件类型

mysql_native_password - 传统认证方式
caching_sha2_password - MySQL 8.0默认
sha256_password - 更安全的认证

检查当前认证方式

                    -- 查看用户认证插件

                    SELECT User, Host, plugin FROM mysql.user;

调试与诊断

使用以下方法诊断认证问题：

                    # 检查MySQL版本

                    SELECT @@version;

                    # 查看默认认证插件

                    SHOW VARIABLES LIKE 'default_authentication_plugin';

                    # 检查用户认证方式

                    SELECT User, Host, plugin FROM mysql.user WHERE User = 'username';

客户端检查

检查PHP的MySQL驱动版本：

                        // 检查mysqlnd版本

                        echo "mysqlnd版本: " . (function_exists('mysqli_get_client_info') ? mysqli_get_client_info() : '不可用');

                        echo "PDO驱动: " . implode(', ', PDO::getAvailableDrivers());

MySQL错误码 2059 分析与解决方案