jboss log4j冲突分析与解决

jboss log4j冲突分析与解决

时间:2009-12-16 01:03来源:未知 作者:admin 点击: 172

次

Log4j 作为日志组件被大多数的系统所使用， Jboss 也不例外的采用了 Log4j 作为它的日志输出组件。 但在使用 JBoss 时，很多人经常碰到一些冲突，这些冲如自己配置的 log4j 文件无效，系统抛 org.jb

Log4j作为日志组件被大多数的系统所使用，Jboss也不例外的采用了Log4j作为它的日志输出组件。

但在使用JBoss时，很多人经常碰到一些冲突，这些冲如自己配置的log4j文件无效，系统抛org.jboss.logging.util.OnlyOnceErrorHandlerobject is not assignable to a or

g.apache.log4j.spi.ErrorHandler variable异常等。为了解决造成这方面的原因，我们需要分析Jboss和log4j的一些关系。本文的下面内提供了一个最佳的配置及对问题的分析，在理解了下面的内容后，相信大家都能解决log4j的冲突问题，并找到符合自己的一种解决方法。

一、最佳无冲突配置

解决jboss和log4j冲突的最理想配置如下：

配置

jboss_server_home/deploy/jbossweb-tomcat55.sar/META-INF/jboss-service.xml文件里的Java2ClassLoadingCompliance及UseJBossWebLoader为false，如果存在WEB-INF/jboss-web.xml，则里面的java2ClassLoadingCompliance及java2ParentDelegaton属性也都设置成false。在webapp里log4j的配置文件采用xml形式，并命名为log4j.xml，同时在webapp的lib里需要包含log4j相关的jar包，通过这样的配置后，webapp的log4j和jboss的log4j将相互隔离互不影响。

二、Log4j载入配置文件的方式

Log4j在查找它的配置文件的时候，默认情况下，首先会在Classloader里查找log4j.xml文件，第一个找到的文件作为它的配置，在找不到log4j.xml文件的情况下，再查找log4j.properties文件，找到则使用这个文件，没有找到则报错。

三、JBoss和Log4j的关系：

关于JBoss启动和ClassLoader模型的关系，请参见:

http://blog.csdn.net/youfly/archive/2009/02/12/3884081.aspx

为了更好的理解下面的内容，如果对JBoss的启动过程和ClassLoader模型不太清楚的话，请先阅读上面的文章。

下图是jbossclassloader和相关的log4j配置文件

四、JBoss启动初始化阶段

JBoss第一次使用Log4j是在JBoss Server实例初始化的时候，也即调用server.init(props)方法的时候，在这个时候JBoss线程的TCL(Thread Context ClassLoader)是NoAnotationURLClassLoader，且Server实例的定义ClassLoader也是NoAnotationURLClassLoader。因此init方法是在

NoAnotataionURLClassLoader的上下文中执行，在执行时，所有的类及相关的资源文件都通过NoAnotatationURLClassLoader来装载。根据JBoss的ClassLoader模型，该ClassLoader可以载入jboss_home/lib目录下的一些jar包及bin/run.jar，具体请参考上面的文章，但它不能访问jboss_server_home/conf目录，所以这个时候没有办法访问jboss_server_home/conf/log4j.xml文件。在第一次使用Log4j时，Log4j会进行初始化，初始化时它首先查找log4j.xml文件，根据ClassLoader的委派模型，它会委派载入log4j.xml资源的请求给SystemClassLoader，这个时候如果sytem classpath里存在log4j.xml文件，Log4j将使用那个文件，如果不存在，则由NoAnotationURLClassLoader自己尝载入，它发现自己也载入不了。Log4j发现

Jboss classloader及相关的log4j的配置文件

找不到log4j.xml文件后，会尝载入log4j.propertes文件，和载入xml文件时类似，它也首先进行委派载入，同理如果systemclasspath里存在

log4j.properties文件，Jboss将使用system classpath里包含的文件，如果不存在NoAnotationURLClassLoader尝试自己进行载入，它可以从

jboss_home/bin/run.jar里找到log4j.properties文件。run.jar包里包含的log4j.properties将JBoss内核初始化启动的调试日志输入到

jboss_server_home/log/boot.log文件的定义。因此可以推断，如果在system classpath里包含log4j.xml或者log4j.properties可能会导致boot.log不能正确的写入，但不会出现什么异常。 五、JBoss部署阶段

Jboss使用Log4j的第二部分是在进行部署的时候，包括SAR，EAR，Jar，EJB……部署。jboss_server_home/conf/jboss-service.xml里配置的log4jService这个MBean service先对log4j进行一个初始化，在默认的配置中，log4j所用的配置文件是classpath里的log4j.xml。在log4j service初始化前，JBoss的所有日志通过都会写到boot.log中。在SARDeployer处理好jboss_server_home/conf/jboss-service.xml文件，并初始化好log4j.xml后，通常jboss的日志就会写入到server.log中。SARDeployer在初始化log4j service的时候，JBoss的线程TCL为包含patchDir(它由jboss.patch.url属性指定)和服务器conf目录的UCL。在服务器目录conf里包含一个log4j.xml文件。因此在log4j service初始化的时候通常使用conf目录下的log4j.xml（即jboss_server_home/conf/log4j.xml），但如果在system classpath包含有一个log4j.xml的话，jboss在初始化log4j时将会使用system clapsspath里的log4j.xml。这会导致server.log不正常的写入，日志的级别及写入的文件受system classpath里的log4j.xml影响。

六、web应用启动并服务阶段

第三部分的log4j相关的部分应该就是我们应用开发里用到的log4j。这里只讨论Webapp的开发。根据JBoss的ClassLoader结构，在默认配置情况下，Webapp所用的ClassLoader是org.jboss.web.tomcat.tc5.WebAppClassLoader。它默认的class载入方式是先检查自己能不能载入请求的类(对于jdk核心的API则也是先请求父类载入)，如果不能载入再请求父ClassLoader载入。这个行为可以通过

jboss_server_home/deploy/jbossweb-tomcat55.sar/META-INF/jboss-service.xml配置文件里的Java2ClassLoadingCompliance属性进行修改，如果这个属性为true，则首先检查父类能不能载入，然后再检查自己能不能载入，这个配置参数在JBossAS- 4.0.3 Final由于bug问题没有作用,bug参见：http://jira.jboss.com/jira/browse/JBAS-2347。当然它也可以通过在WEB-IN/jboss-web.xml这个文件里进行配置