【Java】web.xml中配置log4j2相关信息，解决配置文件不生效问题

由log4j升级到log4j2的过程，因spring升级4.3.X后放弃了log4j1

maven依赖的相关包

<slf4j.version>1.7.21</slf4j.version>
<log4j.version>2.7</log4j.version>

<!--1-->
<dependency>
    <groupId>org.apache.logging.log4j</groupId>
    <artifactId>log4j-api</artifactId>
    <version>${log4j.version}</version>
</dependency>
<!--2-->
<dependency>
    <groupId>org.apache.logging.log4j</groupId>
    <artifactId>log4j-core</artifactId>
    <version>${log4j.version}</version>
</dependency>
<!--3-->
<dependency>
    <groupId>org.apache.logging.log4j</groupId>
    <artifactId>log4j-1.2-api</artifactId>
    <version>${log4j.version}</version>
</dependency>
<!--4-->
<dependency>
    <groupId>org.apache.logging.log4j</groupId>
    <artifactId>log4j-jcl</artifactId>
    <version>${log4j.version}</version>
</dependency>
<!--5-->
<!-- 桥接：告诉Slf4j使用Log4j2 -->
<dependency>
    <groupId>org.apache.logging.log4j</groupId>
    <artifactId>log4j-slf4j-impl</artifactId>
    <version>${log4j.version}</version>
</dependency>
<!--6-->
<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-api</artifactId>
    <version>${slf4j.version}</version>
</dependency>
<!--7-->
<!--<dependency>-->
    <!--<groupId>org.apache.logging.log4j </groupId>-->
    <!--<artifactId>log4j-jul</artifactId>-->
    <!--<version>${log4j.version}</version>-->
<!--</dependency>-->
<!--8-->
<dependency>
    <groupId>org.apache.logging.log4j</groupId>
    <artifactId>log4j-web</artifactId>
    <version>${log4j.version}</version>
    <scope>runtime</scope>
</dependency>
<!-- apache commons-logging 实际调用slf4j -->
<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>jcl-over-slf4j</artifactId>
    <version>${slf4j.version}</version>
    <scope>runtime</scope>
</dependency>
<!-- 桥接：log4j1使用Log4j2 也支持其他实现到log4j的桥接，引入不同的jar包即可-->
<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>log4j-over-slf4j</artifactId>
    <version>${slf4j.version}</version>
</dependency>
<!-- 日志：end-->

需要注意的是项目中其他包用到了log4j，而不是log4j2的需要在maven依赖的包下面加上

<exclusion>
     <groupId>log4j</groupId>
     <artifactId>log4j</artifactId>
 </exclusion>

web.xml中配置

<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>
<context-param>
    <param-name>log4jConfiguration</param-name>
    <param-value>classpath:/env/${env-dir}/log4j2.xml</param-value>
</context-param>

这里需要提示下，如果加上了下面的内容（会有配置文件不生效的情况）

<context-param>
    <param-name>isLog4jContextSelectorNamed</param-name>
    <param-value>true</param-value>
</context-param>
<context-param>
    <param-name>log4jContextName</param-name>
    <param-value>appWithJndiSelector</param-value>
</context-param>

• 如果isLog4jContextSelectorNamed是true，则必须指定log4jContextName或必须在web.xml中指定appWithJndiSelector(名字随意，测试过好像没什么重要作用);否则，会报错。在这种情况下也应该指定log4jConfiguration，并且必须是 configuration 文件的有效 URI，否则配置无效不可用;但是，此参数不是必需的；这里需要注意的是，log4j2的配置文件，项目打包的之后一定要放到classes目录下，且文件名开头为log4j2或log4j2-，不让会报错:
  ERROR StatusLogger No log4j2 configuration file found. Using default configuration: logging only errors to the console

• 如果isLog4jContextSelectorNamed不是true，则可以选择指定log4jConfiguration，并且必须是 configuration 文件的有效 URI 或路径，或者以classpath：开头，以表示可在 classpath 上找到的 configuration 文件。如果没有此参数，Log4j 将使用标准机制来定位 configuration 文件。如果使用mvn -P dev传递指定配置文件，可以这么配置classpath:/env/${env-dir}/log4j2.xml

maven 配置
<profiles>
    <profile>
        <id>dev</id>
        <properties>
            <env-dir>dev</env-dir>
        </properties>
    </profile>
<profiles>

• 默认情况下，Log4j 2 使用ServletContext的context name作为LoggerContext name，并使用标准 pattern 来定位 Log4j configuration 文件。您可以使用三个 context 参数来控制此行为。第一个isLog4jContextSelectorNamed指定是否应使用JndiContextSelector选择 context。如果未指定isLog4jContextSelectorNamed或true以外的任何内容，则假定为false。

项目中使用

package com.auto.controller;

import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.Logger;

public class AutoParamController {

    private static final Logger logger = LogManager.getLogger(AutoParamController.class);

    public ModelAndView commonParm(ModelAndView modelAndView, int projectId) {
        logger.info("List CaseParamBean {} {}", lcbp.size(), "test");
    }
}

参阅源码：org.apache.logging.log4j.web.Log4jWebInitializerImpl.start 方法

参考官网：https://logging.apache.org/log4j/2.x/manual/webapp.html

The notes made by jwensh On March 14, 2020