关于struts2的error filterStart问题的解决

今天一位网友让polaris帮忙解决一些jqGrid的问题。在polaris部署运行其工程时，却抛出Struts2 Error filterStart异常，也就是根本连tomcat都启动不了。

由于polaris在初学Struts2的时候就遇到过该问题，之后也陆陆续续遇到过不少次，今天又遇到了此问题，而且按以前的解决方法该问题依然 存在。当然最后把该问题还是解决了。这个问题相信很多人都遇到过，各种情况可能也不一样，于是polaris在此对该问题做一个总结，一来作为以后查阅， 二来也可以给遇到此问题的人一个参考。

1、Error filterStart异常的详细堆栈信息

2010-9-26 20:28:25 org.apache.catalina.core.StandardContext filterStart
严重: Exception starting filter struts2
java.lang.NullPointerException
at com.opensymphony.xwork2.util.FileManager$FileRevision.needsReloading(FileManager.java:209)
at com.opensymphony.xwork2.util.FileManager.fileNeedsReloading(FileManager.java:60)
at com.opensymphony.xwork2.config.providers.XmlConfigurationProvider.needsReload(XmlConfigurationProvider.java:325)
……
at org.apache.catalina.startup.Bootstrap.start(Bootstrap.java:289)
at org.apache.catalina.startup.Bootstrap.main(Bootstrap.java:414)
2010-9-26 20:28:25 org.apache.catalina.core.StandardContext start
严重: Error filterStart
2010-9-26 20:28:25 org.apache.catalina.core.StandardContext start
严重: Context [/jqgridTest] startup failed due to previous errors
2010-9-26 20:28:25 org.apache.catalina.loader.WebappClassLoader clearThreadLocalMap
严重: A web application created a ThreadLocal with key of type [null] (value [com.opensymphony.xwork2.inject.ContainerImpl$10@1f7e273]) and a value of type [java.lang.Object[]] (value [[Ljava.lang.Object;@1342572]) but failed to remove it when the web application was stopped. To prevent a memory leak, the ThreadLocal has been forcibly removed.
2010-9-26 20:28:25 org.apache.catalina.loader.WebappClassLoader clearThreadLocalMap
严重: A web application created a ThreadLocal with key of type [null] (value [com.opensymphony.xwork2.inject.ContainerImpl$10@869e8f]) and a value of type [java.lang.Object[]] (value [[Ljava.lang.Object;@13ccea]) but failed to remove it when the web application was stopped. To prevent a memory leak, the ThreadLocal has been forcibly removed.
2010-9-26 20:28:25 org.apache.catalina.loader.WebappClassLoader clearThreadLocalMap
严重: A web application created a ThreadLocal with key of type [null] (value [com.sun.faces.config.ConfigureListener$1@1f23ca4]) and a value of type [null] (value [null]) but failed to remove it when the web application was stopped. To prevent a memory leak, the ThreadLocal has been forcibly removed.

polaris注：中间有省略，异常可能不完全一样，但大概就是这个样子。

2、解决方法总结

2.1 解决方法一

初学Struts2的时候，很容易遇到该问题。这个时候，首先查看导入的JAR包是否正确，一般是少导入了什么JAR包。记得当初在学Struts2的时候，polaris就遇到导入JAR包的问题，可参看polaris早时刚学Struts2时在百度空间上写的文章《解决struts2 中Error filterStart 问题》。

2.2 解决方法二

进入公司后，遇到了类似的问题。其实这个问题可能跟Struts2没关系，不过还是在此提一下。大概的问题是：程序编译出问题，或者通过 Eclipse将程序部署到Tomcat后，启动Tomcat报错。当时遇到此问题感觉很是奇怪，因为在同事电脑上一切都正常。后来才发现，原来这是通过 SVN导致的：由于每个人的classpath路径不一样（Eclipse中有一个文件.classpath），第一次通过将工程上传到SVN后，会上传 该文件（不上传也会有此问题），这样其他人从SVN上下载该工程时，classpath和自己机子上的不一样，导致找不到jar包，自然就会编译出问题， 或者部署出问题。解决方法是将所有的JAR包重新导入一次。如图：

将这些jar包全部删除，然后点击add jars，在当前工程的lib目录下将所有的jar导入进来。记得有时候还可能需要重新设置JDK，因为JDK各个人的名称可能不一样，如jdk1.6， jdk1.6.0.3之类的，这样也会导致编译出错。

2.3 解决方法三

遇到此问题另外一个要想到的问题是配置文件是否有问题。首先当然是web.xml文件，要确保Struts2过滤器配置无误；然后是struts.xml配置文件。

今天polaris遇到的问题就是struts.xml引起的问题。该网友他部署的时候是没有问题的，他在该配置文件中启用了devMode模式。 然后，我将其禁用掉，发现问题解决。然而，虽然解决了问题，却有疑问：为啥网友的机子上不会有问题？这个时候想到了“空格”问题：polaris的 Tomcat安装在Program Files目录中。通过与网友一确认，他的Tomcat安装目录没有空格。

以下来源于网络：devMode模式是开发模式，开启它则默认开启了i18n.reload、configuration.xml.reload。 这个错误是由于configuration.xml.reload设置为true倒导致的，网上的资料没有说明原因及解决办法，有人说这是2.16版本的 BUG，tomcat的安装路径包含空格，你可以使用更高级的版本或将Tomcat安装到没有空格的路径中来避免这个错误。

3、说明

以上是对Struts2 Error filterStart异常的一个总结。如果您遇到该问题，而以上方法没法解决，可以留言或联系polaris，或者您对该问题有其他的解决方法也可留言告之，谢谢。

本文初稿完成于2010/9/26 23:02