JDBC 連接 MySQL 實戰指南：從驅動載入到資源關閉的標準流程

前言：Java 資料庫連接的標準化橋樑

JDBC (Java Database Connectivity) 為 Java 應用與關聯式資料庫提供統一 API。無論底層資料庫為 MySQL、PostgreSQL、Oracle 或 SQL Server，核心步驟高度一致。本文以 MySQL 為例，示範完整的連接、查詢與資源管理流程。

JDBC 六大核心步驟

1. 載入驅動程式：Class.forName("com.mysql.cj.jdbc.Driver")（JDBC 4.0+ 可省略，自動 SPI 發現）
2. 建立連線：DriverManager.getConnection(url, user, pass)
3. 建立 Statement：conn.createStatement() 或 PreparedStatement
4. 執行 SQL：executeQuery() (SELECT) / executeUpdate() (DML/DDL)
5. 處理結果集：ResultSet.next() 迭代 + getXxx() 取值
6. 關閉資源：逆序關閉 ResultSet → Statement → Connection

完整範例程式碼

import java.sql.*;

public class DBConnection {
    public static void main(String[] args) {
        // 1. 連線參數
        String driver = "com.mysql.cj.jdbc.Driver"; // MySQL 8.0+ 驅動類別
        String url = "jdbc:mysql://localhost:3306/userdb?useSSL=false&serverTimezone=UTC";
        String username = "test";
        String password = "test";
        String sql = "SELECT username, useradd, userage FROM user";

        Connection conn = null;
        Statement stmt = null;
        ResultSet rs = null;

        try {
            // 2. 載入驅動 (JDBC 4.0+ 可省略)
            Class.forName(driver);

            // 3. 建立連線
            conn = DriverManager.getConnection(url, username, password);

            // 4. 建立 Statement
            stmt = conn.createStatement();

            // 5. 執行查詢
            rs = stmt.executeQuery(sql);

            // 6. 處理結果集
            while (rs.next()) {
                // 兩種取值方式：索引 (1-based) 或欄位名
                System.out.println("username: " + rs.getString(1));
                System.out.println("useradd:  " + rs.getString("useradd"));
                System.out.println("userage:  " + rs.getInt("userage"));
                System.out.println("-------------------");
            }

        } catch (ClassNotFoundException e) {
            System.err.println("驅動程式未找到：請確認 mysql-connector-java.jar 在 classpath 中");
            e.printStackTrace();
        } catch (SQLException e) {
            System.err.println("資料庫操作異常：" + e.getMessage());
            e.printStackTrace();
        } finally {
            // 7. 逆序關閉資源（每個獨立 try-catch 確保全部釋放）
            closeQuietly(rs);
            closeQuietly(stmt);
            closeQuietly(conn);
        }
    }

    // 輔助方法：靜默關閉
    private static void closeQuietly(AutoCloseable resource) {
        if (resource != null) {
            try { resource.close(); } catch (Exception ignored) {}
        }
    }
}

關鍵細節深度解析

1. 連線 URL 參數詳解

jdbc:mysql://host:port/dbname?key1=value1&key2=value2
常用參數：
  useSSL=false           // 本地開發關閉 SSL
  serverTimezone=UTC     // 避免時區警告
  characterEncoding=UTF-8 // 強制 UTF-8
  allowPublicKeyRetrieval=true // MySQL 8.0 公鑰檢索
  autoReconnect=true     // 自動重連（生產環境建議用連線池而非此選項）

2. Statement vs PreparedStatement

// PreparedStatement 範例
String sql = "SELECT * FROM user WHERE username = ? AND userage > ?";
try (PreparedStatement ps = conn.prepareStatement(sql)) {
    ps.setString(1, "admin");
    ps.setInt(2, 18);
    try (ResultSet rs = ps.executeQuery()) { /* ... */ }
}

3. 資源管理：Try-with-Resources (Java 7+)

自動關閉實作 AutoCloseable 的資源，碼更簡潔安全：

try (Connection conn = DriverManager.getConnection(url, user, pass);
     PreparedStatement ps = conn.prepareStatement(sql);
     ResultSet rs = ps.executeQuery()) {

    while (rs.next()) { /* 處理 */ }
} catch (SQLException e) { /* 處理異常 */ }
// 無需 finally，編譯器自動生成關閉碼

4. 常見異常與排查

• ClassNotFoundException：驅動 JAR 未加入 classpath。
• Communications link failure：主機/埠錯誤、防火牆、MySQL bind-address 設定。
• Access denied：帳號密碼錯誤、權限不足、flush privileges 未執行。
• Zero date value prohibited：MySQL 5.7+ 預設嚴格模式，需 URL 加 zeroDateTimeBehavior=CONVERT_TO_NULL。

生產環境建議：連線池

頻繁開關物理連線極其昂貴。實務上**必須使用連線池**：

• HikariCP：極速、輕量、Spring Boot 2+ 預設
• Druid：阿里出品、監控強大、中文文檔豐富
• DBCP2 / Tomcat JDBC Pool：傳統選擇

// HikariCP 範例
HikariConfig config = new HikariConfig();
config.setJdbcUrl(url);
config.setUsername(user);
config.setPassword(pass);
config.setMaximumPoolSize(20);
DataSource ds = new HikariDataSource(config);

// 使用
try (Connection conn = ds.getConnection()) { /* ... */ }

總結

• 掌握 JDBC 六步驟，理解每步用途與異常處理。
• **優先使用 PreparedStatement** 防注入、提效能。
• **Java 7+ 必用 try-with-resources** 管理資源。
• 生產環境**務必接入連線池**，不可手動管理物理連線。
• URL 參數根據 MySQL 版本與環境調整，避免時區、SSL、編碼坑。