Eclipse 連接 MySQL 資料庫完整實戰教學 (含 JDBC 驅動配置)

本文記錄從 MySQL 安裝、建立測試資料、Eclipse 專案建立、JDBC 驅動匯入到 Java 程式連線測試與資料操作的完整流程，解決常見連線失敗問題。

一、環境準備

• MySQL: mysql-essential-5.1.51-win32
• JDBC 驅動: mysql-connector-java-5.1.xx-bin.jar
• Eclipse: 任意版本

二、MySQL 建立測試資料

CREATE DATABASE test;
USE test;
CREATE TABLE user (name VARCHAR(20), password VARCHAR(20));
INSERT INTO user VALUES ('huzhiheng', '123456');

三、Eclipse 專案配置 JDBC

1. 右鍵專案 → Build Path → Add External Archives...
2. 選擇 mysql-connector-java-x.x.xx-bin.jar
3. 確認 Libraries 頁籤顯示驅動包

四、Java 連線測試程式

import java.sql.*;

public class MysqlJdbc {
    public static void main(String[] args) {
        // 1. 載入驅動
        try {
            Class.forName("com.mysql.jdbc.Driver");
            System.out.println("Success loading Mysql Driver!");
        } catch (Exception e) {
            System.out.print("Error loading Mysql Driver!");
            e.printStackTrace();
        }

        // 2. 建立連線
        try {
            Connection conn = DriverManager.getConnection(
                "jdbc:mysql://localhost:3306/test", "root", "198876");
            System.out.println("Success connect Mysql server!");

            // 3. 查詢資料
            Statement stmt = conn.createStatement();
            ResultSet rs = stmt.executeQuery("SELECT * FROM user");
            while (rs.next()) {
                System.out.println(rs.getString("name"));
            }
        } catch (Exception e) {
            System.out.print("get data error!");
            e.printStackTrace();
        }
    }
}

五、批次插入 100 筆測試資料

PreparedStatement pstmt = conn.prepareStatement("INSERT INTO user VALUES (?, ?)");
for (int i = 0; i < 100; i++) {
    pstmt.setString(1, "chongshi" + i);
    pstmt.setString(2, "bo" + i);
    pstmt.executeUpdate();
}

六、MySQL 驗證資料

SHOW DATABASES;
USE test;
SHOW TABLES;
SELECT * FROM user;

七、常見連線失敗排查

• 驅動類別名稱是否正確：com.mysql.jdbc.Driver (5.x) / com.mysql.cj.jdbc.Driver (8.x)
• 連線 URL 格式：jdbc:mysql://主機:埠/資料庫?參數
• 帳號密碼、資料庫名、表名拼寫
• MySQL 服務是否啟動、防火牆 3306 埠是否開放
• MySQL 8.0+ 需加時區參數：?serverTimezone=UTC