JDBC 環境建置完整指南：JDK、MySQL、驅動程式與資料庫建立

JDBC 開發環境建置是 Java 連接資料庫的前置作業。本文系統整理從 JDK 安裝、環境變數設定、MySQL 資料庫安裝、JDBC 驅動配置到建立測試資料庫與資料表的完整流程，適合初學者快速建立可用的開發環境。

1. JDK 安裝與環境變數設定

驗證：命令列執行 java -version 顯示版本資訊即成功。

2. MySQL 資料庫安裝

1. 下載 MySQL Community Server（Windows 安裝包 .msi）
2. 安裝時設定 root 密碼，記住埠號（預設 3306）
3. 建議同步安裝 MySQL Workbench（GUI 管理工具）

3. JDBC 驅動程式配置

下載驅動

取得 mysql-connector-j-8.x.x.jar（對應 MySQL 8.0+）或舊版 mysql-connector-java-5.1.xx.jar。

Eclipse/IDE 專案配置

1. 專案右鍵 → Properties → Java Build Path → Libraries
2. Classpath → Add External JARs → 選擇驅動 jar
3. Apply and Close

Maven/Gradle 專案（推薦）

<!-- Maven -->
<dependency>
    <groupId>com.mysql</groupId>
    <artifactId>mysql-connector-j</artifactId>
    <version>8.2.0</version>
</dependency>

# Gradle
implementation 'com.mysql:mysql-connector-j:8.2.0'

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

使用 MySQL Workbench 或命令列：

-- 建立資料庫
CREATE DATABASE emp CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

-- 切換資料庫
USE emp;

-- 建立員工表
CREATE TABLE employees (
    id INT NOT NULL PRIMARY KEY,
    age INT NOT NULL,
    first_name VARCHAR(255),
    last_name VARCHAR(255)
);

-- 插入測試資料
INSERT INTO employees VALUES 
(100, 18, 'Zara', 'Ali'),
(101, 25, 'Mahnaz', 'Fatma'),
(102, 30, 'Zaid', 'Khan'),
(103, 28, 'Sumit', 'Mittal');

5. 常見問題排查

• Communications link failure：檢查 MySQL 服務是否啟動、防火牆、bind-address 設定
• ClassNotFoundException：驅動 jar 未加入類別路徑
• Access denied：帳號密碼錯誤或權限不足，需 GRANT ALL ON emp.* TO 'user'@'%'
• 時區錯誤：連線字串加入 ?serverTimezone=Asia/Taipei

現代化開發建議

實務專案建議使用 Spring Boot + HikariCP + MyBatis/JPA，由框架自動管理資料源、連線池與事務，僅需在 application.yml 設定連線參數即可。