您现在的位置：程式碼之家 >> 編程語言 > >> 更多程式語言 >> 程式設計疑難解答

Eclipse/Java 專案 MySQL 驅動 JAR 依賴管理最佳實踐

編輯：程式設計疑難解答

問題現象

專案 A 手動加入 MySQL 驅動 JAR，專案 B 新增驅動時 Eclipse 自動關聯到專案 A 的 JAR 路徑，導致版本衝突、部署遺漏。

解決方案：建立共用 Library (User Library)

步驟 1：建立 User Library

Eclipse 選單：Window → Preferences → Java → Build Path → User Libraries
點擊 New...，命名：MySQL Driver
選中該 Library，點擊 Add External JARs...
選擇 mysql-connector-java-x.x.xx.jar (建議放在固定目錄，如 D:\DevLibs\mysql\)
點擊 OK 完成

步驟 2：專案引用 Library

右鍵專案 → Build Path → Configure Build Path
分頁 Libraries → Add Library...
選擇 User Library → Next
勾選 MySQL Driver → Finish

優點

**版本集中管理**：升級驅動只需更新 User Library 中的 JAR，所有專案自動生效
**路徑固定**：避免專案間相對路徑混亂
**團隊共享**：將 .metadata/.plugins/org.eclipse.core.runtime/.settings/org.eclipse.jdt.core.prefs 納入版控，或匯出 User Library 定義檔分享

進階：Maven/Gradle 專案 (現代標準)

若專案使用建構工具，**勿手動管理 JAR**，直接在配置檔宣告：

Maven (pom.xml)

<dependency>
    <groupId>com.mysql</groupId>
    <artifactId>mysql-connector-j</artifactId> <!-- 8.0+ 群組變更 -->
    <version>8.2.0</version>
</dependency>

Gradle (build.gradle)

dependencies {
    implementation 'com.mysql:mysql-connector-j:8.2.0'
}

Eclipse 專案轉 Maven 步驟

右鍵專案 → Configure → Convert to Maven Project
編輯生成的 pom.xml 加入依賴
Maven → Update Project 自動下載至 Maven Dependencies
移除手動加入的 JAR / User Library 引用

常見問題對照

問題	原因	解決
ClassNotFoundException: com.mysql.jdbc.Driver	驅動 JAR 未在 Classpath / 版本不符 (8.0+ 類別名變更)	檢查依賴、確認類別名: `com.mysql.cj.jdbc.Driver`
多專案驅動版本不一致	各自手動加入不同版本 JAR	統一使用 User Library 或 Maven 父專案管理版本
部署 WAR/JAR 缺少驅動	Build Path 僅編譯時有效，Runtime 需打包	Maven 自動打包；手動專案需勾選 `Order and Export` 或放入 `WEB-INF/lib`

最佳實踐總結

新專案：直接使用 Maven/Gradle 宣告依賴
舊專案未用建構工具：建立 User Library 集中管理
團隊協作：共享 User Library 定義或統一遷移至 Maven
驅動版本：MySQL 8.0+ 使用 mysql-connector-j、類別名 com.mysql.cj.jdbc.Driver、URL 加時區 ?serverTimezone=UTC