spring+mybatis启动NoClassDefFoundError异常分析三部曲之一（稳定重现问题） _Mybatis

少年击剑更吹箫，剑气箫心一例消。这篇文章主要讲述spring+mybatis启动NoClassDefFoundError异常分析三部曲之一：稳定重现问题相关的知识，希望能为你提供帮助。
欢迎访问我的GitHub

不久前，web项目在发布的时候应用启动失败了，错误信息如下：

org.springframework.web.context.ContextLoader] - Context initialization failed java.lang.NoClassDefFoundError: Could not initialize class org.springframework.beans.factory.BeanCreationException at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.doCreateBean(AbstractAutowireCapableBeanFactory.java:547) at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.createBean(AbstractAutowireCapableBeanFactory.java:475) at org.springframework.beans.factory.support.AbstractBeanFactory$1.getObject(AbstractBeanFactory.java:304) at org.springframework.beans.factory.support.DefaultSingletonBeanRegistry.getSingleton(DefaultSingletonBeanRegistry.java:228) at org.springframework.beans.factory.support.AbstractBeanFactory.doGetBean(AbstractBeanFactory.java:300) at org.springframework.beans.factory.support.AbstractBeanFactory.getBean(AbstractBeanFactory.java:195) at org.springframework.beans.factory.support.DefaultListableBeanFactory.preInstantiateSingletons(DefaultListableBeanFactory.java:700) at org.springframework.context.support.AbstractApplicationContext.finishBeanFactoryInitialization(AbstractApplicationContext.java:760) at org.springframework.context.support.AbstractApplicationContext.refresh(AbstractApplicationContext.java:482) at org.springframework.web.context.ContextLoader.configureAndRefreshWebApplicationContext(ContextLoader.java:403) at org.springframework.web.context.ContextLoader.initWebApplicationContext(ContextLoader.java:306) at org.springframework.web.context.ContextLoaderListener.contextInitialized(ContextLoaderListener.java:106) at org.apache.catalina.core.StandardContext.listenerStart(StandardContext.java:5118) at org.apache.catalina.core.StandardContext.startInternal(StandardContext.java:5634) at org.apache.catalina.util.LifecycleBase.start(LifecycleBase.java:145) at org.apache.catalina.core.ContainerBase.addChildInternal(ContainerBase.java:899) at org.apache.catalina.core.ContainerBase.addChild(ContainerBase.java:875) at org.apache.catalina.core.StandardHost.addChild(StandardHost.java:652) at org.apache.catalina.startup.HostConfig.deployDirectory(HostConfig.java:1260) at org.apache.catalina.startup.HostConfig$DeployDirectory.run(HostConfig.java:2002) at java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:511) at java.util.concurrent.FutureTask.run(FutureTask.java:266) at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1142) at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:617) at java.lang.Thread.run(Thread.java:745)
组里的同事们对比了本次发布的改动，再结合异常去网上搜索，很快就定位到了问题所在，在mybatis的配置文件中，我们经常做如下配置：

< bean class="org.mybatis.spring.mapper.MapperScannerConfigurer"> < property name="basePackage" value="https://www.songbingjia.com/android/com.ssm.dao" /> < /bean>

正常情况下，这样配置后mybatis就会扫码com.ssm.dao目录下的接口，我们在业务代码中autowire的这些接口，就会被注入实例化好的动态代理对象，这是正常的用法。
但是在com.ssm.dao目录下的接口达到某个数量范围后，应用启动时就会失败，而错误信息就是上面的那个。
解决的方法很简单，把配置改成下面这样就行了：
< bean class="org.mybatis.spring.mapper.MapperScannerConfigurer"> < property name="basePackage" value="https://www.songbingjia.com/android/com.ssm.dao" /> < property name="sqlSessionFactoryBeanName" value="https://www.songbingjia.com/android/sqlSessionFactory"> < /property> < /bean>
增加了一个sqlSessionFactoryBeanName属性的节点，注意sqlSessionFactory是我们早就配置好的：

< bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean"> < property name="dataSource" ref="dataSource" /> < !-- 自动扫描mapping.xml文件 --> < property name="mapperLocations" value="https://www.songbingjia.com/android/classpath:com/ssm/mapping/*.xml"> < /property> < /bean>
这样配置后再次启动就成功了，业务验证也正常，不过虽然问题解决了，但是对问题的来龙去脉并不清楚，所以很有必要做深入的了解和分析；
周末经过一番折腾对问题有了更深的了解，由于涉及东西不少，因此打算分三篇文章由浅入深的分析，本人水平有限，实践和认识上有不对之处欢迎随时交流，谢谢啦；
三篇文章的重点依次是：
1. 构造环境，使问题可以稳定重现，这样我们断点也好，改代码也好，可以用更多的手段去定位和分析问题；
2. 追踪，定位问题；
3. 分析问题，为何会导致此问题，寻找解决之道；
本章作为三部曲之一，目标是让问题稳定重现，下面开始实践吧：准备tomcat
本次实战，我用tomcat是7.0.75版本，为了让应用在启动时更容易报错，需要对tomcat的启动参数做一下设置，把栈的大小调得更小一些，打开tomcat安装目录下的bin目录，打开catalina.bat文件，找到这一行：
set "JAVA_OPTS=%JAVA_OPTS% %JSSE_OPTS%"

改成

set "JAVA_OPTS=%JAVA_OPTS% %JSSE_OPTS% -Xss160K"
低于160k的话，启动tomcat会失败，提示不能低于160k；
至于为什么调小了这个参数会使应用启动更容易报错，其实启动报错的更本原因就是栈溢出StackoverFlowError（后面的章节会详细讨论），这里栈越小就越容易报错了；准备数据库
mybatis相关的应用是和mysql数据库有关的，要建数据库和对应的表，这里我建了一个库和一个表，导入了一条记录，如果应用启动成功运行正常，是可以访问到这条记录的：
数据库名称：mybatistest
建表和增加数据的sql如下：
CREATE TABLE `user_t` ( `id` bigint(20) NOT NULL AUTO_INCREMENT, `user_name` varchar(255) NOT NULL DEFAULT , `password` varchar(255) NOT NULL DEFAULT , `age` bigint(20) DEFAULT NULL, PRIMARY KEY (`id`) ) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8;

【spring+mybatis启动NoClassDefFoundError异常分析三部曲之一（稳定重现问题）】insert into user_t (user_name, password, age) values (Tom, 123456, 11);

- 对于电脑上没有装mysql的读者，如果已经装了docker，这里推荐用docker直接run一个mysql容器： ```shell docker run --name mysql001 -idt -e MYSQL_ROOT_PASSWORD=888888 -p 3306:3306 daocloud.io/library/mysql:8

一行命令把mysql装好，再执行docker exec -it mysql001 /bin/bash
进入容器把数据库和表建好；准备代码
公司的代码拿来做实验和写博客自然是不太合适的，所以这里我准备了一套简单的demo，一样可以重现问题，demo的源码在git上，地址：git@github.com:zq2599/blog_demos.git
下载后可以发现里面有很多工程，本次实战用的工程是springmybatisexceptiondemo，如下图红框所示：

spring+mybatis启动NoClassDefFoundError异常分析三部曲之一（稳定重现问题）

文章图片

这是个普通的spring＋mybatis的web应用，数据库的配置在jdbc.properties文件中，请读者结合自己的mysql配置进行修改；
这个应用可以直接在tomcat上运行起来，数据库准备好，该应用部署到tomcat后，在浏览器输入http://localhost:8080/springmybatisexceptiondemo/user/showUser?id=1，可以看到如下页面：

文章图片

如图所示，数据库的数据被读取并展示到页面上；重现问题
打开工程中的spring-mybatis.xml文件，修改的地方如下图红框所示，把红框中的内容注释掉，使其不生效：

文章图片

再次部署在tomcat上，这时候就可以在tomcat控制台上看到应用启动失败的日志，如下图：

文章图片
至此，问题已经可以稳定复现，就等我们通过各种手段去定位和分析了，下一章，我们会深入到spring内部，去探究问题来龙去脉；