java.lang.ClassNotFoundException: org.springframework.web.context.ContextLoaderListener
在使用 Spring 框架构建一个 Web 工程的时候,我们需要在 web.xml 中配置了一个 Spring 的上下文监听器:
1 <!-- 服务器启动时,在Context域中初始化一个applicationContext --> 2 <listener> 3 <listener-class>org.springframework.web.context.ContextLoaderListener 4 </listener-class> 5 </listener>
随后在启动 Tomcat 服务器后,Console 控制台报错java.lang.ClassNotFoundException:org.springframework.web.context.ContextLoaderListener。
异常描述:
1 严重: Error configuring application listener of class 2 org.springframework.web.context.ContextLoaderListener 3 java.lang.ClassNotFoundException: org.springframework.web.context.ContextLoaderListener 4 at org.apache.catalina.loader.WebappClassLoaderBase.loadClass 5 (WebappClassLoaderBase.java:1858) 6 at org.apache.catalina.loader.WebappClassLoaderBase.loadClass 7 (WebappClassLoaderBase.java:1701) 8 at org.apache.catalina.core.DefaultInstanceManager.loadClass 9 (DefaultInstanceManager.java:504) 10 at org.apache.catalina.core.DefaultInstanceManager.loadClassMaybePrivileged 11 (DefaultInstanceManager.java:486) 12 at org.apache.catalina.core.DefaultInstanceManager.newInstance 13 (DefaultInstanceManager.java:113) 14 at org.apache.catalina.core.StandardContext.listenerStart 15 (StandardContext.java:4984) 16 at org.apache.catalina.core.StandardContext.startInternal 17 (StandardContext.java:5584) 18 at org.apache.catalina.util.LifecycleBase.start(LifecycleBase.java:147) 19 at org.apache.catalina.core.ContainerBase.addChildInternal(ContainerBase.java:899) 20 at org.apache.catalina.core.ContainerBase.addChild(ContainerBase.java:875) 21 at org.apache.catalina.core.StandardHost.addChild(StandardHost.java:652) 22 at org.apache.catalina.startup.HostConfig.deployDirectory(HostConfig.java:1260) 23 at org.apache.catalina.startup.HostConfig$DeployDirectory.run(HostConfig.java:2002) 24 at java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:511) 25 at java.util.concurrent.FutureTask.run(FutureTask.java:266) 26 at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1142) 27 at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:617) 28 at java.lang.Thread.run(Thread.java:745)
错误分析:
错误的意思很明确:找不到“ org.springframework.web.context.ContextLoaderListener”这个类,ContextLoaderListener 这个类是在 spring-web.jar 包下,仔细检查了项目 jar 环境,发现在 Web 项目下 lib 导入的 spring 的 jar 包中,确实缺少导入一个名为 spring-web-4.3.8.RELEASE.jar 的 jar 包。然后导入,重新启动 Tomcat 服务器即可顺利通过。
问题补充:
如果在检查了项目 jar 环境,发现该 jar 包确实存在,而且也能找到编译后的 ContextLoaderListener.class 文件。但在启动 Tomcat 服务器后,Console 控制台依旧报错 java.lang.ClassNotFoundException:org.springframework.web.context.ContextLoaderListener。
问题的原因可能是你导入的仅仅是 jar 包的引用,例如在 eclipse 的 build path 直接引用的 jar 包(类似快捷方式),没有把 jar 文件拷贝到 lib 目录下。即使这种在 Java Application 中没有问题,但在 web Application 中也可能会出现找不到类的异常。
我们知道JVM虚拟机是根据 Java ClassLoader (类加载器)决定如何加载 Class。 系统默认提供了3个 ClassLoader 。Root ClassLoader、ClassPath Loader 和 Ext ClassLoader 。
而 web Application 使用的是自定义的 ClassLoader,而非JVM中的存在的三种 ClassLoader。所以它无法识别出我们写在 xml 文件中的第三方类库的 class 文件,而只有我们写在 src 目录下的 java 文件才能使用。
因此,我们必须要把所需的第三方的类库放入到 WEB-INF/lib 目录下,web Application 才会识别我们定义在 xml 中的类。然后再重新启动 Tomcat 服务器便可顺利通过。