JDBC 環境建置完整指南：JDK、資料庫、驅動程式與環境變數設定

前言

JDBC (Java Database Connectivity) 是 Java 操作關聯式資料庫的標準 API。本文整理從 JDK 安裝、環境變數設定、資料庫安裝（以 MySQL 為例）、JDBC 驅動部署到建立測試資料表的完整步驟。

1. JDK 安裝與環境變數

• 下載 JDK（建議 JDK 8/11/17 LTS），安裝至 C:\Program Files\Java\jdk-17
• 設定系統環境變數：
  • JAVA_HOME = JDK 安裝目錄
  • PATH 追加 %JAVA_HOME%\bin
  • CLASSPATH = .;%JAVA_HOME%\lib;%JAVA_HOME%\jre\lib（現代 JDK 通常不需手動設定）
• 驗證：java -version、javac -version

2. 資料庫安裝 (MySQL 8.0)

• 下載 MySQL Community Server，執行安裝精靈，設定 root 密碼。
• 安裝 MySQL Workbench（GUI 管理工具）。
• 下載 MySQL Connector/J (JDBC 驅動)，解壓取得 mysql-connector-j-8.x.x.jar。
• 將 jar 加入專案 Classpath（Maven/Gradle 專案請加入 dependency）。

3. 建立測試資料庫與資料表

-- 命令列或 Workbench 執行
CREATE DATABASE emp;
USE emp;

CREATE TABLE employees (
    id INT PRIMARY KEY,
    age INT NOT NULL,
    first_name VARCHAR(50),
    last_name VARCHAR(50)
);

INSERT INTO employees VALUES
(100, 18, 'Zara', 'Ali'),
(101, 25, 'Mahnaz', 'Fatma'),
(102, 30, 'Zaid', 'Khan'),
(103, 28, 'Sumit', 'Mittal');

4. JDBC 連線測試程式

import java.sql.*;

public class JdbcTest {
    static final String URL = "jdbc:mysql://localhost:3306/emp?useSSL=false&serverTimezone=UTC";
    static final String USER = "root";
    static final String PASS = "your_password";

    public static void main(String[] args) {
        try (Connection conn = DriverManager.getConnection(URL, USER, PASS);
             Statement stmt = conn.createStatement();
             ResultSet rs = stmt.executeQuery("SELECT * FROM employees")) {
            while (rs.next()) {
                System.out.printf("%d\t%d\t%s\t%s%n",
                    rs.getInt("id"), rs.getInt("age"),
                    rs.getString("first_name"), rs.getString("last_name"));
            }
        } catch (SQLException e) { e.printStackTrace(); }
    }
}

常見問題

• ClassNotFoundException：驅動 jar 未加入 Classpath。
• Communications link failure：資料庫未啟動、Port 錯誤、防火牆阻擋。
• 時區問題：URL 加入 serverTimezone=UTC 或 Asia/Taipei。