JDBC连接MySQL出现ClassNotFoundException，已试多方案仍未解决

你已经尝试了几种常见的驱动jar添加方式，但还是碰到了类找不到的报错——核心原因其实是JVM在运行时没有真正加载到MySQL的JDBC驱动类，我来梳理几个容易被忽略的排查点：

1. 先核对驱动版本与MySQL版本的匹配性 #

你代码里用的com.mysql.cj.jdbc.Driver是MySQL 8.0及以上版本的专属驱动类，对应的驱动jar必须是mysql-connector-java 8.x系列；如果你的MySQL是5.x版本，就得换成com.mysql.jdbc.Driver，驱动jar也用5.x版本。版本不匹配是这类问题最常见的诱因，先确认两者版本对应。

2. 检查IDE的运行配置（如果用IDE开发） #

很多时候我们把jar加到了项目Build Path，但运行时的Classpath并没有同步：

• Eclipse：右键项目 → Run As → Run Configurations → 切换到Classpath标签，查看User Entries里是否包含你的MySQL驱动jar，没有的话点击Add External JARs添加进去。
• IDEA：打开Run/Debug Configurations → 你的运行配置 → 切换到Classpath标签，确认驱动jar在其中；如果用Maven/Gradle管理依赖，直接在配置文件中添加依赖会更可靠，避免手动添加的遗漏：
  Maven依赖示例：

  <dependency>
      <groupId>mysql</groupId>
      <artifactId>mysql-connector-java</artifactId>
      <version>8.0.33</version> <!-- 替换成你需要的版本 -->
  </dependency>
  

3. 命令行运行时的类路径指定 #

如果是手动用命令行编译运行，编译阶段不需要驱动，但运行时必须明确指定类路径包含驱动jar：

• Linux/macOS：

  javac Main.java
  java -cp .:/path/to/your/mysql-connector-java-8.x.jar Main
  

• Windows：

  javac Main.java
  java -cp .;C:\path\to\your\mysql-connector-java-8.x.jar Main
  

  这里的.代表当前目录，分号/冒号是路径分隔符，后面跟上驱动jar的绝对路径。

4. 验证驱动jar的完整性 #

有时候下载的jar包可能损坏，导致无法读取内部的类文件。你可以重新从MySQL官方下载对应版本的驱动，解压后使用里面的mysql-connector-java-x.x.xx.jar文件替换之前的jar。

另外补充：从JDBC 4.0（Java 6及以上）开始，DriverManager会自动扫描jar包中META-INF/services/java.sql.Driver文件里的驱动类，理论上可以不用写Class.forName("com.mysql.cj.jdbc.Driver")；如果你的jar包里没有这个文件，说明jar可能有问题，这也能辅助验证。

你的代码逻辑本身没问题，重点还是驱动jar的加载环节，按上面的步骤排查应该能解决问题。

内容的提问来源于stack exchange，提问作者Danny boon