SSH2框架访问WEB应用异常解决之：AnnotationProcessor

今天在部署一个WEB应用后，访问时，Tomcat报错，错误信息如下：

2014-11-30 12:13:23 org.apache.coyote.http11.Http11Protocol start
信息: Starting Coyote HTTP/1.1 on http-8080
2014-11-30 12:13:23 org.apache.jk.common.ChannelSocket init
信息: JK: ajp13 listening on /0.0.0.0:8009
2014-11-30 12:13:23 org.apache.jk.server.JkMain start
信息: Jk running ID=0 time=0/23  config=null
2014-11-30 12:13:23 org.apache.catalina.startup.Catalina start
信息: Server startup in 5796 ms
2014-11-30 12:13:58 org.apache.catalina.core.StandardWrapperValve invoke
严重: Servlet.service() for servlet jsp threw exception
java.lang.ClassCastException: org.apache.catalina.util.DefaultAnnotationProcessor cannot be cast to org.apache.AnnotationProcessor
at org.apache.jasper.servlet.JspServletWrapper.getServlet(JspServletWrapper.java:151)
at org.apache.jasper.servlet.JspServletWrapper.service(JspServletWrapper.java:338)
at org.apache.jasper.servlet.JspServlet.serviceJspFile(JspServlet.java:313)
at org.apache.jasper.servlet.JspServlet.service(JspServlet.java:260)
at javax.servlet.http.HttpServlet.service(HttpServlet.java:717)
at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:290)
at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:206)
at org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter.doFilter(StrutsPrepareAndExecuteFilter.java:88)
at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:235)
at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:206)
at org.springframework.orm.hibernate3.support.OpenSessionInViewFilter.doFilterInternal(OpenSessionInViewFilter.java:198)
at org.springframework.web.filter.OncePerRequestFilter.doFilter(OncePerRequestFilter.java:76)
at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:235)
at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:206)
at org.apache.catalina.core.StandardWrapperValve.invoke(StandardWrapperValve.java:233)
at org.apache.catalina.core.StandardContextValve.invoke(StandardContextValve.java:191)
at org.apache.catalina.core.StandardHostValve.invoke(StandardHostValve.java:127)
at org.apache.catalina.valves.ErrorReportValve.invoke(ErrorReportValve.java:102)
at org.apache.catalina.core.StandardEngineValve.invoke(StandardEngineValve.java:109)
at org.apache.catalina.connector.CoyoteAdapter.service(CoyoteAdapter.java:298)
at org.apache.coyote.http11.Http11Processor.process(Http11Processor.java:859)
at org.apache.coyote.http11.Http11Protocol$Http11ConnectionHandler.process(Http11Protocol.java:588)
at org.apache.tomcat.util.net.JIoEndpoint$Worker.run(JIoEndpoint.java:489)
at java.lang.Thread.run(Thread.java:619)

通过诊断发现了问题，解决问题的方法是：

修改Tomcat配置文件： context.xml

在其中的<context />标签中加入：  <Loader delegate="true" />

重新启动Tomcat服务器，问题得到了解决。

原因分析：

首先，你需要了解一下JVM的Classloader机制

简而言之，JVM的classloader加载继承关系分为BootstarpClassLoader --> ExtClassLoader --> SystemClassLoader，应用的WebAppClassLoader继承自SystemClassLoader，在加载具体某个类时，一般会先委托给父类ClassLoader，当父类ClassLoader无法加载成功时，才会再由子类ClassLoader尝试加载，这就是所谓的delegate机制。

其次，Tomcat在jvm的ClassLoader机制上增加了几个继承层次。
SystemClassLoader --> CommonClassLoader -->(ServerClassLoader | SharedClassLoader --> WebAppClassLoader)。
CommonClassLoader用来加载${CATALINA_HOME}/conf/catalina.properties中common.loader配置目录下的类文件，一般是用来加载${CATALINA_HOME}/lib下的文件。该loader加载的类为tomcat服务器和tomcat下面的所有webApp所共享。
ServerClassLoader用来加载${CATALINA_HOME}/conf/catalina.properties中server.loader配置目录下的类文件，一般是用来加载${CATALINA_HOME}/server下的文件。该loader加载的类为tomcat服务器所独有核心类，tomcat下面的WebApp无法访问。
SharedClassLoader用来加载${CATALINA_HOME}/conf/catalina.properties中shared.loader配置目录下的类文件，一般是用来加载${CATALINA_HOME}/shared下的文件。该loader加载的类为tomcat下面的所有webApp所共享。
WebAppClassLoader用来加载${CATALINA_HOME}/webapps/目录下每个WebApp应用的/WEB-INF/class，/WEB-INF/lib的类文件，每个WebApp对应一个WebAppClassLoader，用来加载其所需要的类文件。

最后，说一下delegate配置的意义。
True，表示tomcat将遵循JVM的delegate机制，即一个WebAppClassLoader在加载类文件时，会先递交给SharedClassLoader加载，SharedClassLoader无法加载成功，会继续向自己的父类委托，一直到BootstarpClassLoader，如果都没有加载成功，则最后由WebAppClassLoader自己进行加载。
False，表示将不遵循这个delegate机制，即WebAppClassLoader在加载类文件时，会优先自己尝试加载，如果加载失败，才会沿着继承链，依次委托父类加载。

在此说一下配置为False需要注意的问题：一旦配置为False，如果你在WebApp中自己定义了一个java.lang.String，则这个String类会有可能覆盖掉jdk中的String类，这也许不是你想要的结果。另外对于多个WebApp公用jar包，你可能会放到${CATALINA_HOME}/shared目录中共享，但是一不小心在应用的/WEB-INF/lib中也包含了一个同名的但版本不一致的jar的话，这就有可能会导致很多奇怪的问题。