[数据库/Java]数据库开发过程中产生的MySQL错误代码及其解决方案

前言

吐槽一下,均是这两天遇到的破烂事儿,搞定了也好,以后出现此类问题也就放心些了。
下列遇到的问题大都是因为MySQL从5.x版本升级到8.0.11(MySQL8.0涉及重大改版)后,跟着连带着出现的情况。

  • 为方便快速检索,本文按照【MySQL错误代码】升序排列
  • 在后续的开发过程,本文将把所遇MySQL错误的相关问题持续更新
  • SELECT VERSION()查看数据库当前版本

1 针对问题 【登录/鉴权 1045(28000)】Access denied for user 'root'@'localhost' (using password: YES)

  • 原因分析
    • 可能情况1: 用户名和密码不匹配 (乃至可能, 数据库连接的配置信息存在空格、多打或少打了字符)
    • 可能情况2: 用户的权限不足 (用户授权 详见 https://www.cnblogs.com/johnnyzen/p/7922780.html)
      • GRANT ALL PRIVILEGES ON databaseName.* TO userName@host IDENTIFIED BY password;
    • 可能情况3: 数据库与应用程序的数据传输过程中产生的【编码 不匹配】问题
      • 可尝试在数据库连接的Url后 添加 useUnicode=true&characterEncoding=UTF-8

2 针对问题 【授权 1410(42000)】ERROR 1410 (42000): You are not allowed to create a user with GRANT

  • 原因:
    • MySQL8.0的重大改版,导致 【创建用户】与【授权】分开执行 ( 即 必须先创建用户,才能后续授权)
  • 解决办法
USE mysql; ## 使用mysql数据库
UPDATE user SET host='%' WHERE user='userName'; # 修改指定用户的host范围
FLUSH PRIVILEGES; # 刷新权限表
GRANT ALL PRIVILEGES ON dataBaseName.* to userName@host; # 授权
FLUSH PRIVILEGES; # 刷新权限表

3 针对问题 【登陆/鉴权 1698(28000)】ERROR 1698 (28000):Access denied for user 'root'@'localhost'" error

参见博客 数据库之MySQL ERROR 1698 (28000) 错误:Access denied for user 'root'@'localhost'" error【摘抄】

4 针对问题 【登陆/鉴权 2059】Unable to load authentication plugin 'caching_sha2_password”

  • 原因
    • MySQL数据库8.0以后,改变了身份验证插件为’caching_sha2_password’ 而之前的身份验证方式(default_authentication_plugin)=mysql_native_password
  • 解决方法
    • 方法一 使用老版本的身份验证插件方式 [in MySQL]
      • ALTER USER userName@host IDENTIFIED WITH mysql_native_password BY ‘用户密码’;
    • 方法二 使用8.0以后的MySQL驱动(java的jdbc包) [in POM.xml and driverName]
      • 1 更新 jdbc的驱动程序(8.0+)
      • [2 修改驱动名(原先的旧驱动名也可继续使用)] com.mysql.jdbc.Driver → com.mysql.cj.jdbc.Driver
<!-- https://mvnrepository.com/artifact/mysql/mysql-connector-java -->
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.15</version>
</dependency>

5 针对问题 java.sql.SQLNonTransientConnectionException: Public Key Retrieval is not allowed

  • 背景
    • 多出现在使用MySQL 8.0以上版本(MySQL连接驱动和版本都是8.0以上)的时候易出现本错误
  • 解决方法
    • 数据库连接的 Url 中 添加: allowPublicKeyRetrieval=true

6 针对问题 Unknown system variable 'query_cache_size'

  • 背景
    • jdbc(mysql-connecter-java)驱动程序的版本太低,导致 数据库驱动程序与数据库版本不适配 (注:查看数据库版本 SELECT VERSION() )
    • MySQL官方: query cache在MySQL5.7.20就已经过时了,而在MySQL8.0之后就已经被移除了。
  • 解决方法
    • 1 更新 jdbc的驱动程序(8.0+)
    • [2 修改驱动名(原先的旧驱动名也可继续使用)] com.mysql.jdbc.Driver → com.mysql.cj.jdbc.Driver
<!-- https://mvnrepository.com/artifact/mysql/mysql-connector-java -->
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.15</version>
</dependency>

7 针对问题 The server time zone value 'Öйú±ê׼ʱ¼ä' is unrecognized or represents more than one time zone. You must configure either the server or JDBC driver (via the serverTimezone configuration property) to use a more specifc time zone value if you want to utilize time zone support.

  • 背景
    • 多出现在使用MySQL 8.0以上版本(MySQL连接驱动和版本都是8.0以上)的时候易出现本错误
  • 解决方法
    • 法一 show variables like '%time_zone%'; set global time_zone='+8:00';
    • 法二 数据库连接的Url后面加上 &serverTimezone=GMT%2B8 【未亲测】

8 参考文献

原文地址:https://www.cnblogs.com/johnnyzen/p/12599171.html