开源 Ruo-Yi 项目引入 Mybatis-Plus:3.5.3 报错ClassNotFoundException：

news2025/6/8 0:22:13

开源 `Ruo-Yi` 项目引入 `Mybatis-Plus:3.5.3` 报错ClassNotFoundException：

Caused by: java.lang.ClassNotFoundException: com.baomidou.mybatisplus.extension.plugins.MybatisPlusInter

1 分析问题

控制台报错说明我们引入的 mybatis-plus 的依赖里找不到com.baomidou.mybatisplus.extension.plugins.MybatisPlusInter这个类。

去查看一下。

如下图所示，我们引入的MP版本是3.5.3，报错显示extesion包里报ClassNotFoundException异常了。

所以，去MP:3.5.3包里查看一下pom.xml文件对应的extesion依赖包的版本，如下图，是extesion:3.5.3。
在这里插入图片描述

接着，去查看extension:3.5.3包里是否有报ClassNotFoundException异常的那个class文件。

如下图所示，是有的。所以我们引入的依赖没有问题。

在这里插入图片描述

不过也很清晰的看到，extension包的版本引入了两个，一个是我们引入的3.5.3，一个是3.3.2。

所以，问题大概在这个extension:3.3.2这个包里。去看一下，这个包里有没有报ClassNotFoundException异常的那个class文件。

如下图所示，没有。那么问题就发现在哪里了。我们需要的是引入的3.5.3版本，但是编译的时候用的是3.3.2这个包。

在这里插入图片描述

所以，这个bug的原因就是MP依赖版本冲突，接下来只要解决掉依赖版本冲突就行了。

2 解决问题

如下，maven helper插件没有识别出这个版本依赖的冲突。

发现这个依赖在ruoyi-generate模块里。

如下，使用maven-helper插件来分析ruoyi-generate模块。确实发现了依赖冲突问题，接下来需要做的事情就是，解决冲突，由于我们需要MP-3.5.3，不需要MP-3.3.2，所以这里直接排除MP-3.3.2就OK咯！

按理说，到这里，没有冲突就好了。

但是，ruoyi-generate模块里又用到了mybatis-plus-extension依赖，就报了如下的错。

在这里插入图片描述

别慌，很简单！

这里我导入了mybatis-plus-annotation:3.5.3的依赖，这两个报错倒是没有了，不过又出现了一个问题。ruoyi-generate这个模块里的这个类用到了IdType.ID_WORKER_STR这个枚举。3.5.3版本里没有这个枚举，所以该怎么解决呢？

在这里插入图片描述

答：原本在这个模块里就使用了3.3.2版本的 MP，所以我猜想这里用到的mybatis-plus-annotation:3.3.2依赖肯定也被排除exclude了。问题又来了，我们刚才排除掉的是mybatis-plus-extension:3.3.2依赖，并没有排除mybatis-plus-annotation:3.3.2依赖。所以我大胆猜想mp-annotation:3.3.2依赖肯定在mp-extension:3.3.2依赖里。

如果是这样，由于我们确实mp-annotation:3.3.2依赖，所以在ruoyi-generate模块里直接引入这个依赖就行了。

如下来验证我们的猜想：

在这里插入图片描述