乐趣区

使用IDEA启动项目遇见ClassNotFoundException的正确解决姿势

jiezi

一. 错误现象

本地开发 SpringBoot 项目的时候，在集成 MyBatis 查询数据库的时候，使用 IDEA 启动项目的时候，有时候会遇见如下的报错：

Caused by: java.sql.SQLException: com.mysql.jdbc.Driver  at com.alibaba.druid.util.JdbcUtils.createDriver  ......  Caused by: java.lang.ClassNotFoundException: com.mysql.jdbc.Driver  at java.net.URLClassLoader.findClass(URLClassLoader.java:382)  .......

二. 正确的解决姿势

1. 是否添加了 mysql 驱动

去 pom.xml 里查看是否添加了 mysql 驱动。如果之前没有添加，需要引入 mysql 的 jar 驱动：

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

重新编译后运行，如果还是报这个错，看第 2 步。

2. 执行 mvn install

执行 IDEA 里的 mvn install 命令，下载可能缺失的 jar 包。如果重新编译后运行还是不行，看第 3 步。

3. 检查配置文件是否有错

.yml 和 .properties 的配置文件对格式都有严格要求，确认一下自己的数据库连接配置是否有格式错误。
比如：

  • 行首和行位是否有空格之类的。

4. 找到原因​

笔者按照前面的 3 个步骤反复检查确认，依然还是报这个错误，折腾了半天。会不会 IDEA 哪个地方的设置有问题。

命令行执行 jar 包

为了验证猜想，于是进到 jar 包所在的工程目录下面，在命令行下直接使用 java -jar 的方式启动：

`java -jar projectName.jar`

却发现服务能够正常启动起来，没有报 java.lang.ClassNotFoundException 这个错误。由于我的项目是 SpringBoot 聚合工程，于是就猜测会不会是这个 模块下的依赖没有被 IDEA 读到呢？

验证猜想

通过 File -> Project Structure -> Project Settings -> Modules 打开 弹窗，选中该模块，在右侧找到 Dependencies 选项卡并打开，在下面会出现该模块依赖的 jar 包列表：

仔细找了一会儿，发现竟然没有找到第 1 步添加的 mysql 的 jar 包。
找到了问题的原因，下面就列出三种解决办法。

5. 添加 Module 的 Dependencies

方式一
  • 打开添加 Dependencies 的弹窗
  • 添加 mysql jar 包

点 + 号，然后选择 Library：

点 Add Selected 保存。

方式二
  • 选中模块后右键


在弹出的菜单中选择 Reimport，则会重新从 pom.xml 里解析并下载依赖。

方式三

如果你在在开发过程中新建了一个模块，然后删除了该模块，后边又新建了一个相同名字的模块，则依赖也是引不进来的。这是因为 IDEA 默认已经删除的模块将不再使用，解决办法：

  1. 打开 项目目录 .idea/misc.xml 文件：


删除掉圈红的该行（对应你之前删掉的模块名）

  1. 重新新建同名的模块，依赖就可以正常导入。

三. 总结

  1. 遇到这种情况，先确认代码级别是否有什么遗漏或者配置文件是否格式有错误，注意不要忘记执行 clean、install、package；

  2. 可以在命令行执行 Jar 包：

    • 如果仍然报同样的错误，则还是在代码级别上有错误，需要仔细的排查；
    • 如果不报错，那就可以确定是 IDEA 在某处的设置有问题，比如 Jar 包的版本默认选择不对、mvn 选择的版本过低、module 的依赖没有引进来等。

关注微信公众号

欢迎大家关注我的微信公众号阅读更多文章：

退出移动版