1.权限问题

MySQL 认证协议不兼容问题解决方案
这个错误表明您的 MySQL 客户端与服务器要求的认证协议不兼容，通常发生在 MySQL 8.0+ 服务器与旧版客户端之间。

nested exception is org.apache.ibatis.exceptions.PersistenceException:

Error querying database. Cause: org.springframework.jdbc.CannotGetJdbcConnectionException: Failed to

obtain JDBC Connection; nested exception is
com.mysql.jdbc.exceptions.jdbc4.MySQLNonTransientConnectionException:
Client does not support authentication protocol requested by server;
consider upgrading MySQL client ### The error may exist in
com/cai/mapper/StudentDao.xml ### The error may involve
com.cai.dao.StudentDao.search ### The error occurred while executing a
query ### Cause:
org.springframework.jdbc.CannotGetJdbcConnectionException: Failed to
obtain JDBC Connection; nested exception is
com.mysql.jdbc.exceptions.jdbc4.MySQLNonTransientConnectionException:
Client does not support authentication protocol requested by server;
consider upgrading MySQL client

解决办法：

方案1：升级 MySQL 客户端（推荐）

更新 Maven/Gradle 依赖：

xml

<dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId><version>8.0.28</version> <!-- 使用最新稳定版 -->
</dependency>

更新 JDBC URL：

properties
spring.datasource.url=jdbc:mysql://localhost:3306/yourdb?useSSL=false&serverTimezone=UTC&allowPublicKeyRetrieval=true

方案2：修改 MySQL 用户认证方式

如果暂时无法升级客户端：

bash
mysql -u root -p
修改用户认证插件：

sql
– 查看当前认证方式

SELECT user, host, plugin FROM mysql.user;

– 修改为旧版认证协议

ALTER USER 'your_username'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_password';

– 刷新权限

FLUSH PRIVILEGES;

或创建新用户：

sql

CREATE USER 'legacy_user'@'%' IDENTIFIED WITH mysql_native_password BY 'password';
GRANT ALL PRIVILEGES ON your_database.* TO 'legacy_user'@'%';
FLUSH PRIVILEGES;

方案3：修改 MySQL 服务器配置（不推荐）

在 my.cnf 或 my.ini 中添加：

ini
[mysqld]
default_authentication_plugin=mysql_native_password
然后重启 MySQL 服务。

验证步骤
检查驱动版本是否更新：

java
System.out.println("MySQL驱动版本: " + com.mysql.cj.jdbc.Driver.class.getPackage().getImplementationVersion());
测试连接：

java
try (Connection conn = DriverManager.getConnection(
“jdbc:mysql://localhost:3306/test?user=root&password=yourpass”)) {
System.out.println(“连接成功!”);
}

2.字符集错误

这个错误是由于 MySQL 客户端（JDBC 驱动）与服务器的字符集协商失败导致的。MySQL 服务器返回了一个客户端无法识别的字符集索引（255，对应 utf8mb4），而旧版本 JDBC 驱动无法处理该索引。

nested exception is org.apache.ibatis.exceptions.PersistenceException:

Error querying database. Cause: org.springframework.jdbc.CannotGetJdbcConnectionException: Failed to

obtain JDBC Connection; nested exception is java.sql.SQLException:
Unknown initial character set index ‘255’ received from server.
Initial client character set can be forced via the ‘characterEncoding’
property. ### The error may exist in com/cai/mapper/StudentDao.xml ###
The error may involve com.cai.dao.StudentDao.search ### The error
occurred while executing a query ### Cause:
org.springframework.jdbc.CannotGetJdbcConnectionException: Failed to
obtain JDBC Connection; nested exception is java.sql.SQLException:
Unknown initial character set index ‘255’ received from server.
Initial client character set can be forced via the ‘characterEncoding’
property.

一、核心原因

字符集不兼容：MySQL 8.0+ 服务器默认使用 utf8mb4 字符集（索引 255），但旧版本 JDBC 驱动（如 mysql-connector-java:5.x）不支持该字符集的索引。
驱动版本过旧：5.x 驱动仅支持 latin1、utf8（非 utf8mb4）等旧字符集，无法识别 utf8mb4 的索引 255。

二、解决方案（分步操作）

1. 升级 MySQL JDBC 驱动到 8.x 版本

MySQL 8.0+ 驱动（mysql-connector-java:8.x）已修复字符集协商问题，支持 utf8mb4 索引 255。

Maven 项目
修改 pom.xml 中的驱动版本（推荐 8.0.33+）：

<dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId><version>8.0.33</version>
</dependency>

Gradle 项目
修改 build.gradle 中的驱动版本：

dependencies {implementation 'mysql:mysql-connector-java:8.0.33'
}

2. 在 JDBC 连接 URL 中显式指定字符集

即使驱动版本正确，仍需在连接 URL 中添加 characterEncoding 参数，强制客户端使用 utf8mb4 字符集（兼容服务器返回的索引 255）。

修改后的连接 URL 示例

jdbc:mysql://localhost:3306/your_database?useSSL=false&                  <!-- 禁用 SSL（可选，若服务器未强制） -->serverTimezone=Asia/Shanghai&  <!-- 设置时区（避免时间戳错误） -->characterEncoding=utf8mb4&     <!-- 显式指定客户端字符集为 utf8mb4 -->allowPublicKeyRetrieval=true   <!-- 允许公钥检索（可选，增强认证兼容性） -->

3. 验证 MySQL 服务器字符集配置

– 查看服务器默认字符集（应为 utf8mb4）

SHOW VARIABLES LIKE 'character_set_server';

– 查看数据库字符集（替换为你的数据库名）

SHOW VARIABLES LIKE 'character_set_database';

若服务器未使用 utf8mb4，可手动修改（推荐）：

– 修改服务器默认字符集（需重启 MySQL 生效）

SET GLOBAL character_set_server = 'utf8mb4';
SET GLOBAL collation_server = 'utf8mb4_unicode_ci';

4. 清理本地仓库并重新构建

旧版本驱动的缓存可能导致配置不生效，需清理本地 Maven/Gradle 仓库：

Maven 清理缓存
删除本地仓库中 mysql-connector-java 的旧版本目录（路径示例）：

~/.m2/repository/mysql/mysql-connector-java/5.1.x/
Gradle 清理缓存
删除 ~/.gradle/caches 目录，重新构建项目：

关闭 IDE，删除缓存目录
rm -rf ~/.gradle/caches
重新导入项目并构建

三、常见问题排查

问题 1：驱动升级后仍报错

原因：驱动未正确加载，或连接 URL 未添加 characterEncoding 参数。

解决：

检查 pom.xml 或 build.gradle 中驱动版本是否为 8.x（如 8.0.33）。
确认连接 URL 包含 characterEncoding=utf8mb4。

问题 2：服务器字符集为 latin1 或其他非 utf8mb4

原因：服务器使用旧字符集，与客户端驱动不兼容。

解决：

修改服务器字符集为 utf8mb4（推荐）：
– 修改服务器默认字符集（需重启 MySQL）
SET GLOBAL character_set_server = ‘utf8mb4’;
SET GLOBAL collation_server = ‘utf8mb4_unicode_ci’;
或在连接 URL 中强制客户端使用服务器支持的字符集（如 latin1）：
jdbc:mysql://localhost:3306/your_database?characterEncoding=latin1