Tomcat 9中为每个Web应用配置独立Log4j 2实例的问题

问题根源 #

Tomcat服务器级别的类加载器共享了LoggerContext，导致两个应用实例复用同一个日志配置路径，所有日志都写入APP1的logs目录。

解决步骤 #

1. 彻底隔离Log4j2依赖 #

• 检查Tomcat的$CATALINA_BASE/lib和$CATALINA_HOME/lib目录，删除所有Log4j2相关jar包（包括log4j-api.jar、log4j-core.jar、log4j-web.jar等），确保每个应用的WEB-INF/lib目录单独包含完整的Log4j2依赖包。
• 每个应用必须包含：log4j-api、log4j-core、log4j-web（web环境下必须，用于上下文隔离）。

2. 修正LoggerContext获取逻辑 #

原代码中LogManager.getContext(false)会复用已有上下文，改为true创建绑定当前应用类加载器的独立上下文，同时用应用类加载器加载配置文件：

// 用当前应用的上下文类加载器获取配置文件
URL configUrl = Thread.currentThread().getContextClassLoader().getResource("log4j2.xml");
System.setProperty("log4j.configurationFile", configUrl.toString());

// 获取绑定当前应用类加载器的独立LoggerContext
LoggerContext context = (LoggerContext) LogManager.getContext(true);
if (!context.isInitialized()) {
    context.initialize();
} else {
    context.reconfigure();
}

3. 配置Log4j2 Web上下文监听器 #

在web.xml中添加Log4jServletContextListener，让log4j-web自动管理应用级别的日志上下文隔离：

<listener>
    <listener-class>org.apache.logging.log4j.web.Log4jServletContextListener</listener-class>
</listener>
<context-param>
    <param-name>log4jConfiguration</param-name>
    <param-value>/WEB-INF/log4j2.xml</param-value>
</context-param>
<!-- Servlet 3.0+可省略Filter，老版本建议添加 -->
<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>

4. 动态配置日志路径 #

在log4j2.xml中使用log4j-web提供的动态变量，避免写死绝对路径，确保每个应用日志写入自身目录：

<Appenders>
    <File name="FileAppender" fileName="${web:rootDir}/logs/app.log" append="true">
        <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
    </File>
</Appenders>

${web:rootDir}对应当前web应用的根目录，会自动适配APP1和APP2的路径。

内容的提问来源于stack exchange，提问作者Ravendhar Kumar Lalwani