Eclipse 中添加第三方 JAR(如 MySQL Connector/J、Oracle JDBC 驅動)是 Java 開發的基本功。本文提供兩種主流方式的圖文級步驟,並解釋「Modulepath vs Classpath」的選擇邏輯,避免「ClassNotFoundException」與「module not found」雙重坑。
mysql-connector-java-8.x.x.jar (官網 / Maven Central)ojdbc8.jar (需登錄 Oracle 賬號下載)postgresql-42.x.x.jarlib(或 libs)。lib 目錄(系統文件管理器拖拽,Eclipse 會自動刷新)。lib/xxx.jar → Apply and Close。Project → Clean,代碼中 Class.forName("com.mysql.cj.jdbc.Driver") 無紅線。關鍵點:Java 9+ 模塊化系統下,JDBC 驅動必須放在 Classpath**,否則模塊系統找不到自動註冊的 java.sql.Driver 服務。
<!-- pom.xml -->
<dependency>
<groupId>com.mysql</groupId>
<artifactId>mysql-connector-j</artifactId>
<version>8.3.0</version>
</dependency>
Eclipse 安裝 m2e 插件後,右鍵專案 → Maven → Update Project 自動下載到 Maven Dependencies 庫(屬 Classpath)。
| 錯誤 | 原因 | 修正 |
|---|---|---|
| ClassNotFoundException: com.mysql.cj.jdbc.Driver | JAR 未加入 Classpath、或放入 Modulepath | 移至 Classpath、Clean 專案 |
| No suitable driver found for jdbc:mysql://... | 驅動未註冊(JAR 損壞/版本不匹配)/ URL 拼寫錯 | 換穩定版 JAR、檢查 URL 格式 |
| module not found: com.mysql.cj.jdbc | JAR 放入 Modulepath 但無 module-info.java | 移至 Classpath |
.prefs 共享。lib/*.jar 建議納入版控(或用 Git LFS),保證開箱即用。