您现在的位置：程式碼之家 >> 編程語言 > >> Java 程式設計 >> Java 程式設計入門

Java JDBC 驅動載入機制詳解：Class.forName、DriverManager、SPI 原理

編輯：Java 程式設計入門

傳統寫法 (JDBC 4.0 前)

Class.forName("com.mysql.cj.jdbc.Driver"); // 顯式載入驅動類
Connection conn = DriverManager.getConnection(url, user, pass);

Class.forName 觸發驅動類靜態初始化塊，驅動在 `` 中呼叫 DriverManager.registerDriver(new Driver()) 註冊自己。

JDBC 4.0+ 自動載入 (SPI 機制)

驅動 JAR `META-INF/services/java.sql.Driver` 文件列出實現類全名。`DriverManager` 初始化時透過 `ServiceLoader` 自動發現並載入，**無需手動 `Class.forName`**。

完整示範程式

import java.sql.*;
import java.util.Enumeration;

public class JdbcDriverLoader {
    public static void main(String[] args) {
        try {
            // 1. 顯式載入 (兼容舊驅動)
            Class.forName("com.mysql.cj.jdbc.Driver");
            // 或 PostgreSQL: org.postgresql.Driver
            // 或 H2: org.h2.Driver

            // 2. 列出已註冊驅動
            Enumeration<Driver> drivers = DriverManager.getDrivers();
            while (drivers.hasMoreElements()) {
                Driver d = drivers.nextElement();
                System.out.println("已載入驅動: " + d.getClass().getName()
                        + " | 主版本: " + d.getMajorVersion()
                        + " | 次版本: " + d.getMinorVersion()
                        + " | JDBC 兼容: " + d.jdbcCompliant());
            }

            // 3. 測試連線 (需有效資料庫)
            // Connection conn = DriverManager.getConnection("jdbc:mysql://localhost:3306/test", "root", "pwd");
            // System.out.println("連線成功: " + conn.getMetaData().getDatabaseProductName());
        }
        catch (ClassNotFoundException e) {
            System.err.println("驅動類未找到，請確認 JAR 在 Classpath: " + e.getMessage());
        }
        catch (SQLException e) {
            System.err.println("驅動註冊/連線異常: " + e.getMessage());
        }
    }
}

常見問題排查

現象	原因	解決
`ClassNotFoundException`	驅動 JAR 不在 Classpath	Maven/Gradle 添加依賴，或手動加入 -cp
`No suitable driver found`	JDBC URL 格式錯誤 / 驅動未註冊	檢查 URL 前綴 (jdbc:mysql://...)，確認 SPI 文件存在
版本衝突	多版本驅動共存 (如 mysql-connector-java 5.x/8.x)	統一版本，排除傳遞依賴
類載入器隔離	應用伺服器 (Tomcat/JBoss) 多層 ClassLoader	驅動放在共享庫 ($CATALINA_HOME/lib) 或使用 `Thread.currentThread().getContextClassLoader()`

最佳實踐

**依賴管理**：Maven `runtime` 引入驅動，編譯期不依賴具體實現。
**連線池**：生產環境**必須**使用 HikariCP / Druid / DBCP2，由連線池管理驅動載入與連線生命週期。
**模組化 (Java 9+)**：使用 `module-info.java` `requires java.sql;`，驅動模組需宣告 `provides java.sql.Driver with com.mysql.cj.jdbc.Driver;`。