解決 JDBC 連接 MySQL 時的 ClassNotFoundException 異常

問題現象

初學者在使用 JDBC 連接 MySQL 時，常遇到 java.lang.ClassNotFoundException: com.mysql.jdbc.Driver 異常，即使已將驅動 JAR 包加入項目，運行仍報錯。

常見原因排查

1. 驅動 JAR 包未正確加入類路徑：在 Eclipse 中需通過 Properties > Java Build Path > Libraries > Add External JARs 添加，或放入 WEB-INF/lib (Web 項目)。
2. JAR 包版本與 JDK 不兼容：確保使用的 mysql-connector-java 版本支持當前 JDK 版本（如 8.0+ 需 JDK 8+）。
3. 類名拼寫錯誤：MySQL 8.0+ 驅動類名為 com.mysql.cj.jdbc.Driver，舊版為 com.mysql.jdbc.Driver。
4. 多類加載器衝突：Web 容器（Tomcat）若在共享庫目錄也放了驅動，可能導致類加載器隔離問題。

解決步驟

1. 確認驅動 JAR 真實存在於構建路徑中（展開 Libraries 查看）。
2. 根據 MySQL 版本選擇正確驅動類名：

   // MySQL 5.x
   Class.forName("com.mysql.jdbc.Driver");
   // MySQL 8.x
   Class.forName("com.mysql.cj.jdbc.Driver");

3. 若使用 Maven/Gradle，直接添加依賴坐標，避免手動管理 JAR：

   <dependency>
       <groupId>mysql</groupId>
       <artifactId>mysql-connector-java</artifactId>
       <version>8.0.33</version>
   </dependency>

4. 清理項目並重新構建（Eclipse: Project > Clean）。

最佳實踐

優先使用構建工具管理依賴，避免手動複製 JAR 導致的版本不一致與路徑問題。