Mybatis-plus 集成到项目中报 NoClassDefFoundError 排查总结

最近项目接入 mybatis 的时候，程序死活起不来，提示 NoClassDefFoundError 错误。

错误如下：

Caused by: java.lang.NoClassDefFoundError: com/baomidou/mybatisplus/annotation/InterceptorIgnore
	at com.baomidou.mybatisplus.core.plugins.InterceptorIgnoreHelper.initSqlParserInfoCache(InterceptorIgnoreHelper.java:50)
	at com.baomidou.mybatisplus.core.MybatisMapperAnnotationBuilder.parse(MybatisMapperAnnotationBuilder.java:100)
	at com.baomidou.mybatisplus.core.MybatisMapperRegistry.addMapper(MybatisMapperRegistry.java:83)
	at com.baomidou.mybatisplus.core.MybatisConfiguration.addMapper(MybatisConfiguration.java:152)
	at org.mybatis.spring.mapper.MapperFactoryBean.checkDaoConfig(MapperFactoryBean.java:80)
	at org.springframework.dao.support.DaoSupport.afterPropertiesSet(DaoSupport.java:44)
	at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.invokeInitMethods(AbstractAutowireCapableBeanFactory.java:1855)
	at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.initializeBean(AbstractAutowireCapableBeanFactory.java:1792)
	... 39 more
Caused by: java.lang.ClassNotFoundException: com.baomidou.mybatisplus.annotation.InterceptorIgnore
	at java.net.URLClassLoader.findClass(URLClassLoader.java:382)
	at java.lang.ClassLoader.loadClass(ClassLoader.java:424)
	at sun.misc.Launcher$AppClassLoader.loadClass(Launcher.java:349)
	at java.lang.ClassLoader.loadClass(ClassLoader.java:357)
	... 47 more

NoClassDefFoundError 发生在程序运行期间，类加载器没有找到该类而报的错误

ClassNotfoundException 发生在程序编译期间，IDE 没有找到该类而报的错误

InterceptorIgnore 出现 NoClassDefFoundError 错误，说明编译没问题，但是在运行的时候找不到。

解决方案

在冥思苦想一整晚之后，发现了解决办法：

查看 maven 依赖，项目里面依赖两个版本的 jar，导致的出错，旧版本确实没有这个类；查看依赖关系发现引入的其它项目的 api 的包里面，包含了旧版本的 mybatis 的依赖，导致有的模块依赖的旧版本，有的模块依赖新版本。

解决方案很简单：exclude 旧版本的 jar 即可

总结

以后发生类似问题，可以先看看，NoClassDefFoundError 的类在哪里，然后看看是否存在 jar 冲突，版本不一致等等问题，一般情况下解决版本冲突即可解决问题。

另外说一句规范，对外发布的 api 包，不应该包含任何第三方 jar，否则真的会影响到对方。