JDBC 连接 MySQL 时碰到的小坑

最近从MS SQL Server换到了MySQL，已经是8.11版本了，安装的时候似乎还用了新的身份认证方式之类的，连接过程中也是磕磕绊绊，碰到很多奇奇怪怪的问题，在此记录下来。

以前使用JDBC时，都是导入相应的JDBC驱动jar包，然后使用

Class.forName(driverName);

加载驱动，再进行数据库连接，在使用MySQL 8.11版本及其对应的Connector时，如果使用上述代码加载com.mysql.jdbc.Driver的话，控制台会输出一行信息：

Loading class `com.mysql.jdbc.Driver‘. This is deprecated. The new driver class is `com.mysql.cj.jdbc.Driver‘. The driver is automatically registered via the SPI and manual loading of the driver class is generally unnecessary.

大概意思是加载的这个类已被弃用，新驱动类是com.mysql.cj.jdbc.Driver，通过SPI自动注册，通常不需要手动加载。注释掉Class.forName后运行就不会产生该输出了。

连接数据库时的URL：

URL前半部分格式固定，需要附加的参数是通过类似网址中的QueryString附着在后面的，格式如下：

jdbc:<_database>://<address>:<port>/<database_name>[?_key1=_value1[&_key2=_value2[&_key3=_value3]...]]

不加参数进行连接时首先会输出这样一行提示信息：

Tue May 08 20:16:40 CST 2018 WARN: Establishing SSL connection without server‘s identity verification is not recommended. According to MySQL 5.5.45+, 5.6.26+ and 5.7.6+ requirements SSL connection must be established by default if explicit option isn‘t set. For compliance with existing applications not using SSL the verifyServerCertificate property is set to ‘false‘. You need either to explicitly disable SSL by setting useSSL=false, or set useSSL=true and provide truststore for server certificate verification.

大概意思是不建议在没有服务器身份验证的情况下建立SSL连接等等，由于本人对SSL并不了解，就直接按照提示在加上参数useSSL=false，就不会产生该输出了。

java.sql.SQLException: 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.

大概意思是服务器的时区值有问题，我这直接就是一团乱码了，按照提示加上参数serverTimezone=Hongkong，就不会产生这个异常了，对于该参数的取值可以查阅相关资料获得，已知东8区可以用Hongkong、Asia/Shanghai或者Asia/Hongkong作为参数取值。

这时可能程序已经能够正常连接数据库了，不过我在调试成功后第二天再次连接时（未对代码进行改动），抛出了一个异常并连接失败，多次尝试无果，该异常如下：

SQLNonTransientConnectionException: Public Key Retrieval is not allowed

对于这个异常网上相关资料很少，多为英文，误打误撞下竟然解决了这个问题，方法为添加一个参数allowPublicKeyRetrieval=true，即可正常连接，而且在连接成功一次后，删除此参数仍然可以正常连接（不懂得都是玄学）......，该方法来自（https://bugs.mysql.com/bug.php?id=75670）下一位dalao的评论：

[20 Aug 2015 19:57] Daniel So
Added the following entry to the Connector/J 6.0 changelog: 

"If the MySQL server‘s default authentication method was SHA256 but neither one of the Connector/J connection properties allowPublicKeyRetrieval and serverRSAPublicKeyFile was set, the authentication failed with a TransientConnectionException, complaining that the public key could not be retrieved. With this fix, authentication continues in the situation, allowing other enabled authentication methods to be tried."

然而并没有看懂。

若需要进行编码转换需要附加参数useUnicode=true 和 characterEncoding=UTF-8。

HTML中常用的特殊字符(Character Entities)

其他常用的字符实体(Character Entities)

No suitable driver found for jdbc:mysql://...

前面提到MySQL启用的旧驱动使用了新的通过SPI自动注册的驱动，在普通Java程序下可以正常运行，但是在Java Web项目中运行在Tomcat8.5环境下时，进行数据库连接操作会抛出异常：

java.sql.SQLException: No suitable driver found for jdbc:mysql://...

大概的意思是找不到合适的JDBC驱动程序，经过检查，已经将使用到的驱动jar包放到了Tomcat的lib目录下，Eclipse中的构建路径也包含了该jar包，在执行连接操作前向控制台打印所用驱动类也存在：

			System.out.println(com.mysql.cj.jdbc.Driver.class);

/*
*输出：
**
*class com.mysql.cj.jdbc.Driver
*
*/

经过搜索得到的答案基本一致（转自：http://www.blogjava.net/w2gavin/articles/217864.html）：

    今天出现编码出现了No suitable driver found for jdbc，又是找遍了网上的资料，基本上都说是三个问题：
    一是：连接URL格式出现了问题(Connection conn=DriverManager.getConnection("jdbc:mysql://localhost:3306/XX","root","XXXX")
    二是：驱动字符串出错(com.mysql.jdbc.Driver)
    三是Classpath中没有加入合适的mysql_jdbc驱动
    经过我的仔细检查，这三种错误我都没有犯，为什么呢？
    尝试着将mysql-connector-java-3.1.14-bin.jar的jar包加入C:\Program Files\Java\jre1.6.0_02\lib\ext文件夹下，问题解决了！！
    原来是不仅仅要求将驱动加入classpath中，而且需要将该jar包加入到java运行环境的外部jar包中，唉，下次这种低级错误还是少犯为妙。

对于这三个说法，本人针对前两条进行了检查，并没有错误，第三条个人认为不正确，Tomcat会自动加载lib下的jar包，况且上面在打印驱动类的Class对象时也确实能看到该类已经被加载，对于下面将驱动jar包放入系统jre下的方（玄）法（学）也并未尝试，不过，在连接数据库操作前加了主动加载驱动类的代码后竟然神（玄）奇（学）的好了：

			System.out.println(com.mysql.cj.jdbc.Driver.class);
			Class.forName(driverName);
			System.out.println("connecting...");
			conn = DriverManager.getConnection(URL, uName, uPwd);
			System.out.println("connect success!");
/*
*输出：
**
*class com.mysql.cj.jdbc.Driver
*connecting...
*connect success!
*
*/

可以看到在手动加载之前该类已经注册，因此这个玄学问题还希望请知道的dalao指教一二！

原文地址：https://www.cnblogs.com/Mimick/p/9011003.html