JDBC 連接 MySQL「無法載入驅動」問題排查：CLASSPATH vs 模組路徑

環境

• JDK 1.6.0_22 + Eclipse + MySQL 5.0.22 + mysql-connector-java-5.1.7-bin.jar
• 專案「建置路徑」已加入 JAR，運行仍報 ClassNotFoundException: com.mysql.jdbc.Driver。

解決方案

將 JAR 複製到 JRE 擴充目錄：

D:\Java\jdk1.6.0_22\jre\lib\ext\mysql-connector-java-5.1.7-bin.jar

重新編譯運行即成功。

根因分析

• Eclipse「建置路徑」僅影響編譯期與 Eclipse 內部運行配置。
• 直接運行 java -cp ... 或外部啟動時，**執行時 CLASSPATH** 決定類別載入。
• jre/lib/ext 是 Java **擴充類別載入器** 掃描目錄，優先於應用 CLASSPATH，全域可見。

最佳實踐（避免污染 JRE）

1. **Maven/Gradle 專案**：
   <dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId><version>8.0.33</version></dependency>
2. **非建構工具**：啟動時指定 -cp 或 --class-path：
   java -cp ".;lib/mysql-connector-java-5.1.7-bin.jar" com.example.Main
3. **Eclipse 運行配置**：Run Configurations → Classpath → User Entries → Add External JARs。
4. **生產部署**：打包成 Fat JAR（maven-shade-plugin）或放入容器 WEB-INF/lib。

版本對應提醒