P10 · 缺 MySQL 驱动 jarClassNotFoundException: com.mysql.cj.jdbc.Driver场景还原你兴冲冲地在项目里写了第一段 JDBC 连接代码运行——啪java.lang.ClassNotFoundException: com.mysql.cj.jdbc.Driver翻译“你要加载的 MySQL 驱动类我翻遍了整个 classpath 都找不到。”说白了项目里根本没引入 MySQL 的驱动 jar 包。一、问题现象开始连接数据库先加载驱动 ... 加载驱动失败找不到这个类多半是没导入 mysql-connector jar java.lang.ClassNotFoundException: com.mysql.cj.jdbc.Driver at java.base/jdk.internal.loader.BuiltinClassLoader.loadClass(BuiltinClassLoader.java:641) at java.base/jdk.internal.loader.ClassLoaders$AppClassLoader.loadClass(ClassLoaders.java:188) at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:526) at java.base/java.lang.Class.forName0(Native Method) at java.base/java.lang.Class.forName(Class.java:423) at MissingJarDemo.main(MissingJarDemo.java:8)二、出错代码publicclassMissingJarDemo{publicstaticvoidmain(String[]args){try{// MySQL 8 的驱动类全名Class.forName(com.mysql.cj.jdbc.Driver);// ← 找不到这个类System.out.println(驱动加载成功可以继续连接了);}catch(ClassNotFoundExceptione){System.out.println( 加载驱动失败找不到这个类多半是没导入 mysql-connector jar);e.printStackTrace();}}}三、为什么会这样Java 连接 MySQL 不是天生就会的——JDBC 只是个接口规范java.sql包真正干活的是驱动实现MySQL 官方提供的mysql-connector-java现在叫mysql-connector-jjar 包。Class.forName(com.mysql.cj.jdbc.Driver)的意思是把驱动类加载进 JVM。这个类住在驱动 jar 里只有把 jar 加进项目的 classpath依赖路径JVM 才能找到它。没加 jar → 找不到类 →ClassNotFoundException。顺带说明MySQL 8 之后的驱动类名是com.mysql.cj.jdbc.DriverMySQL 5.x 时代的老驱动类名是com.mysql.jdbc.Driver。类名写错比如 8 的驱动用 5 的类名也会报找不到——这种情况详见下一篇 P11。四、怎么解决方案一最常用用 Maven/Gradle 加依赖一行搞定自动下载!-- pom.xml --dependencygroupIdcom.mysql/groupIdartifactIdmysql-connector-j/artifactIdversion8.0.33/version!-- 和你的 MySQL 服务端大版本匹配8.x 就选 8.x --/dependency// build.gradleimplementationcom.mysql:mysql-connector-j:8.0.33方案二手动下载 jar 放 lib 目录不用构建工具的老项目去 Maven 中央仓库下载mysql-connector-j-8.0.33.jar放进项目的lib/目录编译运行都带上它javac-encodingUTF-8-cplib/mysql-connector-j-8.0.33.jar YourClass.javajava-cp.:lib/mysql-connector-j-8.0.33.jar YourClass方案三确认依赖真的进来了IDEA 里依赖加了对不对Maven 项目右侧 Maven 面板点刷新Reload看External Libraries里有没有mysql-connector-j-x.x.x.jarGradle 项目同理刷新一下命令行排查mvn dependency:tree | grep mysql看依赖是否解析成功。五、防坑总结连 MySQL 前先确认驱动 jar 已在依赖里ClassNotFoundException 几乎都是没引 jarMySQL 8 用com.mysql.cj.jdbc.Drivermysql-connector-j8.x别拿 5.x 的类名硬凑jar 版本和 MySQL 服务端版本大版本一致8 对 8、5.7 对 5.x见下一篇IDEA 加依赖后记得刷新 Maven/GradleExternal Libraries里肉眼可见才算数从零搭 JDBC 建议直接用连接池HikariCP 等驱动依赖会自动带好。下一篇P11 · MySQL 驱动版本过旧连不上 MySQL 8待发布
P10 · 缺 MySQL 驱动 jarClassNotFoundException: com.mysql.cj.jdbc.Driver场景还原你兴冲冲地在项目里写了第一段 JDBC 连接代码运行——啪java.lang.ClassNotFoundException: com.mysql.cj.jdbc.Driver翻译“你要加载的 MySQL 驱动类我翻遍了整个 classpath 都找不到。”说白了项目里根本没引入 MySQL 的驱动 jar 包。一、问题现象开始连接数据库先加载驱动 ... 加载驱动失败找不到这个类多半是没导入 mysql-connector jar java.lang.ClassNotFoundException: com.mysql.cj.jdbc.Driver at java.base/jdk.internal.loader.BuiltinClassLoader.loadClass(BuiltinClassLoader.java:641) at java.base/jdk.internal.loader.ClassLoaders$AppClassLoader.loadClass(ClassLoaders.java:188) at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:526) at java.base/java.lang.Class.forName0(Native Method) at java.base/java.lang.Class.forName(Class.java:423) at MissingJarDemo.main(MissingJarDemo.java:8)二、出错代码publicclassMissingJarDemo{publicstaticvoidmain(String[]args){try{// MySQL 8 的驱动类全名Class.forName(com.mysql.cj.jdbc.Driver);// ← 找不到这个类System.out.println(驱动加载成功可以继续连接了);}catch(ClassNotFoundExceptione){System.out.println( 加载驱动失败找不到这个类多半是没导入 mysql-connector jar);e.printStackTrace();}}}三、为什么会这样Java 连接 MySQL 不是天生就会的——JDBC 只是个接口规范java.sql包真正干活的是驱动实现MySQL 官方提供的mysql-connector-java现在叫mysql-connector-jjar 包。Class.forName(com.mysql.cj.jdbc.Driver)的意思是把驱动类加载进 JVM。这个类住在驱动 jar 里只有把 jar 加进项目的 classpath依赖路径JVM 才能找到它。没加 jar → 找不到类 →ClassNotFoundException。顺带说明MySQL 8 之后的驱动类名是com.mysql.cj.jdbc.DriverMySQL 5.x 时代的老驱动类名是com.mysql.jdbc.Driver。类名写错比如 8 的驱动用 5 的类名也会报找不到——这种情况详见下一篇 P11。四、怎么解决方案一最常用用 Maven/Gradle 加依赖一行搞定自动下载!-- pom.xml --dependencygroupIdcom.mysql/groupIdartifactIdmysql-connector-j/artifactIdversion8.0.33/version!-- 和你的 MySQL 服务端大版本匹配8.x 就选 8.x --/dependency// build.gradleimplementationcom.mysql:mysql-connector-j:8.0.33方案二手动下载 jar 放 lib 目录不用构建工具的老项目去 Maven 中央仓库下载mysql-connector-j-8.0.33.jar放进项目的lib/目录编译运行都带上它javac-encodingUTF-8-cplib/mysql-connector-j-8.0.33.jar YourClass.javajava-cp.:lib/mysql-connector-j-8.0.33.jar YourClass方案三确认依赖真的进来了IDEA 里依赖加了对不对Maven 项目右侧 Maven 面板点刷新Reload看External Libraries里有没有mysql-connector-j-x.x.x.jarGradle 项目同理刷新一下命令行排查mvn dependency:tree | grep mysql看依赖是否解析成功。五、防坑总结连 MySQL 前先确认驱动 jar 已在依赖里ClassNotFoundException 几乎都是没引 jarMySQL 8 用com.mysql.cj.jdbc.Drivermysql-connector-j8.x别拿 5.x 的类名硬凑jar 版本和 MySQL 服务端版本大版本一致8 对 8、5.7 对 5.x见下一篇IDEA 加依赖后记得刷新 Maven/GradleExternal Libraries里肉眼可见才算数从零搭 JDBC 建议直接用连接池HikariCP 等驱动依赖会自动带好。下一篇P11 · MySQL 驱动版本过旧连不上 MySQL 8待发布
