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

Posted 2022-04-16 程序员欣宸

欢迎访问我的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="com.ssm.dao" />
    </bean>

• 正常情况下，这样配置后mybatis就会扫码com.ssm.dao目录下的接口，我们在业务代码中autowire的这些接口，就会被注入实例化好的动态代理对象，这是正常的用法。

• 但是在com.ssm.dao目录下的接口达到某个数量范围后，应用启动时就会失败，而错误信息就是上面的那个。

• 解决的方法很简单，把配置改成下面这样就行了：

  <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
      <property name="basePackage" value="com.ssm.dao" />
      <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"></property>
  </bean>

• 增加了一个sqlSessionFactoryBeanName属性的节点，注意sqlSessionFactory是我们早就配置好的：

  <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
      <property name="dataSource" ref="dataSource" />
      <!-- 自动扫描mapping.xml文件 -->
      <property name="mapperLocations" value="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;

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上，地址：[e-mail]:zq2599/blog_demos.git

• 下载后可以发现里面有很多工程，本次实战用的工程是springmybatisexceptiondemo，如下图红框所示：

• 这是个普通的spring＋mybatis的web应用，数据库的配置在jdbc.properties文件中，请读者结合自己的mysql配置进行修改；

• 这个应用可以直接在tomcat上运行起来，数据库准备好，该应用部署到tomcat后，在浏览器输入http://localhost:8080/springmybatisexceptiondemo/user/showUser?id=1，可以看到如下页面：

• 如图所示，数据库的数据被读取并展示到页面上；

  重现问题

• 打开工程中的spring-mybatis.xml文件，修改的地方如下图红框所示，把红框中的内容注释掉，使其不生效：
  
  再次部署在tomcat上，这时候就可以在tomcat控制台上看到应用启动失败的日志，如下图：
  

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

欢迎关注51CTO博客：程序员欣宸