最近项目为了对接docker，升级日志组件，但是由于项目用到的一些东西版本比较低，所以遇到了一些问题。
项目版本说明：

• Spring版本 3.2.9
• JDK版本 1.7
• Servlet版本 2.5

日志改造说明

1. maven依赖

    <!--log4j2日志配置-->
    <!--桥接使用log4j的项目-->
    <dependency>
      <artifactId>log4j-1.2-api</artifactId>
      <groupId>org.apache.logging.log4j</groupId>
      <version>2.11.1</version>
    </dependency>
<!--   使用slf4j作为统一日志接口-->
    <dependency>
      <artifactId>slf4j-api</artifactId>
      <groupId>org.slf4j</groupId>
      <version>1.7.25</version>
    </dependency>
<!--   log4j2依赖-->
    <dependency>
      <artifactId>log4j-core</artifactId>
      <groupId>org.apache.logging.log4j</groupId>
      <version>2.11.1</version>
    </dependency>
<!--    桥接使用common-logging的项目-->
    <dependency>
      <artifactId>log4j-jcl</artifactId>
      <exclusions>
        <exclusion>
          <artifactId>commons-logging</artifactId>
          <groupId>commons-logging</groupId>
        </exclusion>
      </exclusions>
      <groupId>org.apache.logging.log4j</groupId>
      <version>2.11.1</version>
    </dependency>

<!--    让slf4j选择log4j2作为日志组件实现-->
    <dependency>
      <artifactId>log4j-slf4j-impl</artifactId>
      <groupId>org.apache.logging.log4j</groupId>
      <version>2.11.1</version>

    </dependency>
<!--    web项目依赖-->
    <dependency>
      <artifactId>log4j-web</artifactId>
      <groupId>org.apache.logging.log4j</groupId>
      <version>2.11.1</version>

    </dependency>
    <!-- https://mvnrepository.com/artifact/com.lmax/disruptor -->
    <dependency>
      <artifactId>disruptor</artifactId>
      <groupId>com.lmax</groupId>
      <version>3.4.2</version>
    </dependency>

关于slf4j版本的说明，因为使用的log4j2版本较低，因为“1.8”大版的slf4j修改了logger的绑定机制，需要日志框架做修改来适配“1.8”大版的slf4j，但是目前“2.11.1”的log4j也还没有做适配。使用的各种桥接包都是为了统一日志组件，其实应用的原理无非是SPI。（一定要排除所有的log4j的jar包）

2. web.xml 改造

<!-- 日志记录 -->
    <context-param>
        <param-name>log4jConfiguration</param-name>
        <param-value>classpath:META-INF/log/log4j2.xml</param-value>
    </context-param>
<!-- log4j2-begin -->
    <listener>
        <listener-class>org.apache.logging.log4j.web.Log4jServletContextListener</listener-class>
    </listener>
    <filter>
        <filter-name>log4jServletFilter</filter-name>
        <filter-class>org.apache.logging.log4j.web.Log4jServletFilter</filter-class>
    </filter>
    <filter-mapping>
        <filter-name>log4jServletFilter</filter-name>
        <url-pattern>/*</url-pattern>
        <dispatcher>REQUEST</dispatcher>
        <dispatcher>FORWARD</dispatcher>
        <dispatcher>INCLUDE</dispatcher>
        <dispatcher>ERROR</dispatcher>
    </filter-mapping>

这里出现的问题比较多，我一一说明，

• servlet版本
  并非maven中依赖的servlet的版本就是servlet的版本，要以web.xml中xsd为准，采用servlet3.0以及以上的版本是不需要进行上述配置的，采用官方文档的描述,

Log4j 2 "just works" in Servlet 3.0 and newer web applications. It is capable of automatically starting when the application deploys and shutting down when the application undeploys. Thanks to the [ServletContainerInitializer] API added to Servlet 3.0, the relevantServletContextListener classes can be registered dynamically on web application startup.
当采用servlet2.5的时候，一定要按照上面的配置进行，详细的配置请参考官方文档log4j2web配置。关于日志的配置这里不做叙述，请参考官方文档。

问题

tomcat服务启动的时候打印出了一段错误日志如下，

ERROR StatusLogger No Log4j 2 configuration file found. Using default configuration (logging only errors to the console), or user programmatically provided configurations. Set system property 'log4j2.debug' to show Log4j 2 internal initialization logging. See https://logging.apache.org/log4j/2.x/manual/configuration.html for instructions on how to configure Log4j 2
上面可以看到其实在web.xml中是配置了log4jConfiguration的，所以日志配置文件是一定存在的，在确定命名以及路径都没有问题之后。我特意找了log4j2的源码进行查看，这段错误日志是在org.apache.logging.log4j.core.config.ConfigurationFactory.Factory#getConfiguration(org.apache.logging.log4j.core.LoggerContext, java.lang.String, java.net.URI)中输出的，这说明日志组件初始化的过程一定出现了问题，仔细查看web.xml中配置的所有内容，能够引发这个问题的只有listener，一共配置了两个listener，一个是spring容器，一个便是日志组件，而Spring容器是先于日志容器初始化的，于是在两个监听器的contextInitialized（）方法中打了断点，发现果然在spring容器初始化的初始化了日志组件，spring内部使用的common-logging组件，由于使用了jcl进行桥接，所以会调用log4j2组件进行初始化，问题就出在这里，我们看下图，

spring容器初始化

spring初始化调用顺序

log4j2获取配置

log4j2初始化

image.png