MySQL 異常有這一篇就夠了!
前言
在本文中,總結(jié)了開(kāi)發(fā)過(guò)程中最為常見(jiàn)的幾種 MySQL 拋出的異常以及如何解決,包括高版本驅(qū)動(dòng)的問(wèn)題、時(shí)區(qū)配置問(wèn)題、SSL 連接問(wèn)題等,是一篇經(jīng)驗(yàn)總結(jié)貼,于我個(gè)人而言,這一篇足以解決目前項(xiàng)目中所有遇到的 MySQL 問(wèn)題。同時(shí),也希望本文能對(duì) MySQL 數(shù)據(jù)庫(kù)初學(xué)者有一定的引導(dǎo)入門(mén)作用。
報(bào)錯(cuò)如下:
- Could not open JDBC Connection for transaction; nested exception is java.sql.SQLException: Connections could not be acquired from the underlying database!
對(duì)于此類(lèi)錯(cuò)誤,直接看釋義,一句話(huà):JDBC 驅(qū)動(dòng)拋出異常,連不上數(shù)據(jù)庫(kù)。
一、代碼配置的數(shù)據(jù)庫(kù)名稱(chēng)或者密碼與本地?cái)?shù)據(jù)庫(kù)不一致
1.1、錯(cuò)誤產(chǎn)生描述
第一種,也是最為常見(jiàn)的一種錯(cuò)誤: 代碼配置的數(shù)據(jù)庫(kù)名稱(chēng)或者密碼與本地?cái)?shù)據(jù)庫(kù)不一致,拋出異常。
如上圖所示,在配置文件中,前面的 name 屬性是默認(rèn)的,無(wú)需改變,對(duì)于用戶(hù)名,一般為 root,可以通過(guò)數(shù)據(jù)庫(kù)管理軟件直接查看本地配置的情況,數(shù)據(jù)庫(kù)的密碼就是你自己設(shè)置的了。
1.2、解決方式
修改配置文件對(duì)應(yīng)的名稱(chēng)和密碼。
二、導(dǎo)入的非本地項(xiàng)目文件與本地的數(shù)據(jù)庫(kù)版本不匹配
2.1、錯(cuò)誤產(chǎn)生描述
第二種常見(jiàn)的錯(cuò)誤:使用 IDE(以 Eclipse 為例)導(dǎo)入的非本地項(xiàng)目文件與本地的數(shù)據(jù)庫(kù)版本不匹配。
舉個(gè)例子:你導(dǎo)入你 eclipse 中的項(xiàng)目里面依賴(lài)的 jar 包是 8.0 的版本,而你本地安裝的是 5.0 的 MySQL 數(shù)據(jù)庫(kù),自然報(bào)錯(cuò)。
2.2、解決方式
在你導(dǎo)入的項(xiàng)目中找到 Referenced Libraries,右擊鼠標(biāo)→Build Path→Configure Build Path…Remove 掉項(xiàng)目里面依賴(lài)的 8.0 的 MySQL 驅(qū)動(dòng),Add 進(jìn)你本地安裝的 5.0 的版本即可。
三、MySQL 高版本配置加載驅(qū)動(dòng)類(lèi)包出錯(cuò)問(wèn)題(以 MySQL 8.0 為例)
這個(gè)錯(cuò)誤是由于 MySQL 版本更新之后,驅(qū)動(dòng)包發(fā)生改變導(dǎo)致的,新的驅(qū)動(dòng)程序類(lèi)是 com.mysql.cj.jdbc.Driver。
3.1、錯(cuò)誤產(chǎn)生描述
報(bào)錯(cuò)如下:
- 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.
錯(cuò)誤說(shuō)明:不建議使用驅(qū)動(dòng)類(lèi)’com.mysql.jdbc.Driver’。新的驅(qū)動(dòng)程序類(lèi)是’com.mysql.cj.jdbc.Driver’,驅(qū)動(dòng)程序是通過(guò) SPI 自動(dòng)注冊(cè)的,通常是不需要手動(dòng)加載驅(qū)動(dòng)類(lèi)。
3.2、解決方式
將 MySQL 數(shù)據(jù)庫(kù) 5.0 使用的驅(qū)動(dòng)類(lèi)com.mysql.jdbc.Driver改為com.mysql.cj.jdbc.Driver,驅(qū)動(dòng)程序是通過(guò) SPI 自動(dòng)注冊(cè)的,通常是不需要手動(dòng)加載驅(qū)動(dòng)類(lèi)。修改之后的配置文件如下圖所示:
- <!-- 加載數(shù)據(jù)庫(kù)驅(qū)動(dòng) -->
- <property name="driverClass" value="com.mysql.cj.jdbc.Driver"></property>
3.3、MySQL 不同版本的驅(qū)動(dòng)類(lèi)如何查看
對(duì)于 MySQL 的驅(qū)動(dòng)類(lèi),我們對(duì)每個(gè)版本進(jìn)行查看時(shí),點(diǎn)開(kāi)驅(qū)動(dòng)的 jar 包可以直接查看驅(qū)動(dòng)是位于哪里,例如 8.0 版本的就是 com.mysql.cj.jdbc.Driver,如下圖所示:
四、數(shù)據(jù)庫(kù)連接字符串高版本配置出錯(cuò)(時(shí)區(qū)問(wèn)題)
注意:MySQL 6.0 版本之后都需要配置時(shí)區(qū)。
4.1、錯(cuò)誤產(chǎn)生描述
報(bào)錯(cuò)如下:
- 2020-01-14 00:45:30,876 ERROR [DruidDataSource.java:616] : init datasource error 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.
錯(cuò)誤說(shuō)明:服務(wù)器時(shí)區(qū)值“????±××?±?無(wú)法識(shí)別或代表一個(gè)以上的時(shí)區(qū)。
4.2、解決方式
我們可以利用時(shí)區(qū)支持,通過(guò)配置服務(wù)器或 JDBC 驅(qū)動(dòng)程序(通過(guò) serverTimezone 配置屬性)以使用更具體的時(shí)區(qū)值。
配置文件如下:
- <!-- 數(shù)據(jù)庫(kù)連接字符串 -->
- <property name="jdbcUrl" value="jdbc:mysql://localhost:3306/demo?serverTimezone=GMT%2B8&characterEncoding=utf-8"></property>
五、為什么數(shù)據(jù)庫(kù)中寫(xiě)入數(shù)據(jù)相差 8 個(gè)小時(shí)?
5.1、錯(cuò)誤產(chǎn)生描述
Java 數(shù)據(jù)庫(kù)連接使用 UTC 時(shí)區(qū)(世界標(biāo)準(zhǔn)時(shí)間),即 serverTimezone=UTC,而北京時(shí)間比 UTC 時(shí)間早8小時(shí),即 UTC+08:00,如果我們直接使用 serverTimezone=UTC,寫(xiě)入數(shù)據(jù)庫(kù)中的數(shù)據(jù)會(huì)提前 8 個(gè)小時(shí)。如果按照如下配置就會(huì)在數(shù)據(jù)庫(kù)中寫(xiě)入數(shù)據(jù)相差 8 個(gè)小時(shí):
- <!-- 數(shù)據(jù)庫(kù)連接字符串 -->
- <property name="jdbcUrl" value="jdbc:mysql://localhost:3306/demo?serverTimezone=UTC&characterEncoding=utf-8"></property>
5.2、解決方式
我們可以修改設(shè)置 serverTimezone 為北京時(shí)間 GMT%2B8、上海時(shí)間 Asia/Shanghai 或者香港時(shí)間 Hongkong。
配置文件如下即可:
- <!-- 數(shù)據(jù)庫(kù)連接字符串 -->
- <property name="jdbcUrl" value="jdbc:mysql://localhost:3306/demo?serverTimezone=GMT%2B8&characterEncoding=utf-8"></property>
另外在 MySQL 中的 my.ini 配置文件也可以修改,此文章僅用于解決相應(yīng)問(wèn)題,故不多做詳細(xì)描述。
六、SSL 連接問(wèn)題
6.1、錯(cuò)誤產(chǎn)生描述
報(bào)錯(cuò)如下:
- Sun Oct 14 00:45:30 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.
錯(cuò)誤說(shuō)明:不建議在沒(méi)有服務(wù)器身份驗(yàn)證的情況下建立 SSL 連接。根據(jù) MySQL 5.5.45+,5.6.26+ 和 5.7.6+ 的 SSL 連接要求,如果未設(shè)置連接方式,則默認(rèn)情況下必須建立 SSL 連接。對(duì)于不使用 SSL 的現(xiàn)有應(yīng)用程序,服務(wù)器的驗(yàn)證證書(shū)屬性設(shè)置為“false”。您需要通過(guò)設(shè)置useSSL = false來(lái)顯式禁用 SSL,或者設(shè)置useSSL = true并提供服務(wù)器的驗(yàn)證證書(shū)。
6.2、解決方式
- 數(shù)據(jù)庫(kù) URL 連接地址添加useSSL = false,適用于測(cè)試。
- 數(shù)據(jù)庫(kù) URL 連接地址添加useSSL = true,并且提供服務(wù)器的驗(yàn)證證書(shū)。
配置文件如下即可:
- <!-- 數(shù)據(jù)庫(kù)連接字符串 -->
- property name="jdbcUrl" value="jdbc:mysql://localhost:3306/demo?useSSL=false&serverTimezone=GMT%2B8&characterEncoding=utf-8"></property>
總結(jié)
通過(guò)對(duì)于 MySQL 拋出異常的幾種常見(jiàn)解決方式的總結(jié),加深對(duì)于 MySQL 底層的了解。只要是干開(kāi)發(fā),錯(cuò)誤是不斷地,要善于總結(jié)。同時(shí),要充分掌握開(kāi)發(fā)的底層原理,不同的版本迭代作為開(kāi)發(fā)者要及時(shí)了解,不然永遠(yuǎn)跟不上技術(shù)的發(fā)展。