Java 项目连接 MySQL 报错：ClassNotFoundException com.mysql.cj.jdbc.Driver

在使用 IntelliJ IDEA 启动 Java 项目时，有时候会遇到以下错误：

java.lang.ClassNotFoundException: com.mysql.cj.jdbc.Driver

这通常发生在项目连接 MySQL 数据库的时候。别担心，这并不是代码写错了，而是 项目缺少 MySQL 驱动或驱动版本不兼容。

一、错误原因分析

1. 缺少 MySQL 驱动依赖
   • 没有在项目里引入 mysql-connector-java。
2. 驱动版本与 JDK 不兼容
   • 使用 JDK 11 或更高版本时，过老的驱动（如 5.x 系列）不再兼容。
   • 建议使用 mysql-connector-j 8.x 版本。
3. 项目依赖未加载成功
   • Maven 没有下载依赖，IDEA 报红。

二、解决方案

1. Maven 项目添加依赖

在 pom.xml 中加入：

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

然后点击 Reload Maven Project。

三、总结

ClassNotFoundException: com.mysql.cj.jdbc.Driver 的根本原因是 项目缺少 MySQL 驱动 或 驱动版本不匹配。

排查思路：

1. 确认是否引入了 mysql-connector-java 依赖
2. 检查 Maven/Gradle 是否成功下载依赖
3. 非 Maven 项目需要手动添加 jar 包到 classpath
4. 检查 JDK 与驱动版本兼容性，推荐使用 mysql-connector-j 8.0.33

这样基本就能解决 IDEA 启动项目时报错的问题。