[[384982]]

前言

在本文中，總結了開發過程中最為常見的幾種 MySQL 拋出的異常以及如何解決，包括高版本驅動的問題、時區配置問題、SSL 連接問題等，是一篇經驗總結貼，于我個人而言，這一篇足以解決目前項目中所有遇到的 MySQL 問題。同時，也希望本文能對 MySQL 數據庫初學者有一定的引導入門作用。

報錯如下：

Could not open JDBC Connection for transaction; nested exception is java.sql.SQLException: Connections could not be acquired from the underlying database!   

對于此類錯誤，直接看釋義，一句話：JDBC 驅動拋出異常，連不上數據庫。

一、代碼配置的數據庫名稱或者密碼與本地數據庫不一致

1.1、錯誤產生描述

第一種，也是最為常見的一種錯誤： 代碼配置的數據庫名稱或者密碼與本地數據庫不一致，拋出異常。

如上圖所示，在配置文件中，前面的 name 屬性是默認的，無需改變，對于用戶名，一般為 root，可以通過數據庫管理軟件直接查看本地配置的情況，數據庫的密碼就是你自己設置的了。

1.2、解決方式

修改配置文件對應的名稱和密碼。

二、導入的非本地項目文件與本地的數據庫版本不匹配

2.1、錯誤產生描述

第二種常見的錯誤：使用 IDE（以 Eclipse 為例）導入的非本地項目文件與本地的數據庫版本不匹配。

舉個例子：你導入你 eclipse 中的項目里面依賴的 jar 包是 8.0 的版本，而你本地安裝的是 5.0 的 MySQL 數據庫，自然報錯。

2.2、解決方式

在你導入的項目中找到 Referenced Libraries，右擊鼠標→Build Path→Configure Build Path…Remove 掉項目里面依賴的 8.0 的 MySQL 驅動，Add 進你本地安裝的 5.0 的版本即可。

三、MySQL 高版本配置加載驅動類包出錯問題（以 MySQL 8.0 為例）

這個錯誤是由于 MySQL 版本更新之后，驅動包發生改變導致的，新的驅動程序類是 com.mysql.cj.jdbc.Driver。

3.1、錯誤產生描述

報錯如下：

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.jdbc.Driver’。新的驅動程序類是’com.mysql.cj.jdbc.Driver’，驅動程序是通過 SPI 自動注冊的，通常是不需要手動加載驅動類。

3.2、解決方式

將 MySQL 數據庫 5.0 使用的驅動類com.mysql.jdbc.Driver改為com.mysql.cj.jdbc.Driver，驅動程序是通過 SPI 自動注冊的，通常是不需要手動加載驅動類。修改之后的配置文件如下圖所示：

<!-- 加載數據庫驅動 --> 
<property name="driverClass" value="com.mysql.cj.jdbc.Driver"></property> 

3.3、MySQL 不同版本的驅動類如何查看

對于 MySQL 的驅動類，我們對每個版本進行查看時，點開驅動的 jar 包可以直接查看驅動是位于哪里，例如 8.0 版本的就是 com.mysql.cj.jdbc.Driver，如下圖所示：

四、數據庫連接字符串高版本配置出錯（時區問題）

注意：MySQL 6.0 版本之后都需要配置時區。

4.1、錯誤產生描述

報錯如下：

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. 

錯誤說明：服務器時區值“？？？？±××？±？無法識別或代表一個以上的時區。

4.2、解決方式

我們可以利用時區支持，通過配置服務器或 JDBC 驅動程序（通過 serverTimezone 配置屬性）以使用更具體的時區值。

配置文件如下：

<!-- 數據庫連接字符串 --> 
<property name="jdbcUrl" value="jdbc:mysql://localhost:3306/demo?serverTimezone=GMT%2B8&characterEncoding=utf-8"></property> 

五、為什么數據庫中寫入數據相差 8 個小時？

5.1、錯誤產生描述

Java 數據庫連接使用 UTC 時區（世界標準時間），即 serverTimezone=UTC，而北京時間比 UTC 時間早8小時，即 UTC+08:00，如果我們直接使用 serverTimezone=UTC，寫入數據庫中的數據會提前 8 個小時。如果按照如下配置就會在數據庫中寫入數據相差 8 個小時：

<!-- 數據庫連接字符串 --> 
<property name="jdbcUrl" value="jdbc:mysql://localhost:3306/demo?serverTimezone=UTC&characterEncoding=utf-8"></property> 

5.2、解決方式

我們可以修改設置 serverTimezone 為北京時間 GMT%2B8、上海時間 Asia/Shanghai 或者香港時間 Hongkong。

配置文件如下即可：

<!-- 數據庫連接字符串 --> 
<property name="jdbcUrl" value="jdbc:mysql://localhost:3306/demo?serverTimezone=GMT%2B8&characterEncoding=utf-8"></property> 

另外在 MySQL 中的 my.ini 配置文件也可以修改，此文章僅用于解決相應問題，故不多做詳細描述。

六、SSL 連接問題

6.1、錯誤產生描述

報錯如下：

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. 

錯誤說明：不建議在沒有服務器身份驗證的情況下建立 SSL 連接。根據 MySQL 5.5.45+，5.6.26+ 和 5.7.6+ 的 SSL 連接要求，如果未設置連接方式，則默認情況下必須建立 SSL 連接。對于不使用 SSL 的現有應用程序，服務器的驗證證書屬性設置為“false”。您需要通過設置useSSL = false來顯式禁用 SSL，或者設置useSSL = true并提供服務器的驗證證書。

6.2、解決方式

1. 數據庫 URL 連接地址添加useSSL = false，適用于測試。
2. 數據庫 URL 連接地址添加useSSL = true，并且提供服務器的驗證證書。

配置文件如下即可：

<!-- 數據庫連接字符串 --> 
property name="jdbcUrl" value="jdbc:mysql://localhost:3306/demo?useSSL=false&serverTimezone=GMT%2B8&characterEncoding=utf-8"></property> 

總結

通過對于 MySQL 拋出異常的幾種常見解決方式的總結，加深對于 MySQL 底層的了解。只要是干開發，錯誤是不斷地，要善于總結。同時，要充分掌握開發的底層原理，不同的版本迭代作為開發者要及時了解，不然永遠跟不上技術的發展。