Log4J2 Routing Appender配置问题：无ThreadContext日志统一存储

核心思路 #

利用Log4J2 Routing Appender的动态路由+默认回退路由机制：

• 为存在threadName上下文变量的线程，生成对应独立日志文件
• 为未设置threadName的线程（如第三方库线程），统一写入默认日志文件

修改后的log4j2.xml配置 #

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="INFO">
    <Appenders>
        <Console name="console" target="SYSTEM_OUT">
            <PatternLayout pattern="%d{ABSOLUTE} %-5p [%-40.-40c{1}] %m%n"/>
        </Console>
        <Routing name="RoutingAppender">
            <!-- 双$符号实现延迟解析，确保运行时获取ThreadContext的动态值 -->
            <Routes pattern="$${ctx:threadName}">
                <!-- 匹配存在threadName的线程，动态生成对应日志文件 -->
                <Route key="$${ctx:threadName}">
                    <RollingFile name="Rolling-${ctx:threadName}"
                                 fileName="../log/${ctx:threadName}.log"
                                 filePattern="../log/${ctx:threadName}-%d{yyyy-MM-dd}.log"
                                 createOnDemand="true">
                        <PatternLayout pattern="%d{ABSOLUTE} %-5p [%-40.-40c{1}] %m%n"/>
                        <Policies>
                            <TimeBasedTriggeringPolicy interval="1" modulate="true"/>
                        </Policies>
                    </RollingFile>
                </Route>
                <!-- 回退路由：处理threadName不存在的情况，统一写入默认日志 -->
                <Route>
                    <RollingFile name="Rolling-Default"
                                 fileName="../log/default.log"
                                 filePattern="../log/default-%d{yyyy-MM-dd}.log"
                                 createOnDemand="true">
                        <PatternLayout pattern="%d{ABSOLUTE} %-5p [%-40.-40c{1}] %m%n"/>
                        <Policies>
                            <TimeBasedTriggeringPolicy interval="1" modulate="true"/>
                        </Policies>
                    </RollingFile>
                </Route>
            </Routes>
        </Routing>
    </Appenders>
    <Loggers>
        <Logger name="de.company" level="INFO" additivity="false">
            <AppenderRef ref="RoutingAppender"/>
            <AppenderRef ref="console"/>
        </Logger>
        <Logger name="com.company" level="INFO" additivity="false">
            <AppenderRef ref="RoutingAppender"/>
            <AppenderRef ref="console"/>
        </Logger>
        <Root level="INFO">
            <AppenderRef ref="RoutingAppender"/>
            <AppenderRef ref="console"/>
        </Root>
    </Loggers>
</Configuration>

关键配置说明 #

1. 延迟变量解析：
   使用$${ctx:threadName}（双美元符号）代替单美元符号写法，让Log4J2在运行时（而非配置加载阶段）解析ThreadContext变量，确保动态生成的线程名称能被正确匹配。
2. 路由匹配逻辑：
   • 第一个带key的<Route>会匹配所有存在threadName的线程，自动创建对应名称的滚动日志文件。
   • 第二个无key的<Route>作为默认回退路由，当threadName不存在时，所有日志会流入这个路由，写入default.log，避免生成${ctx:threadName}.log这类无效命名的文件。
3. 资源优化：
   保留createOnDemand="true"，避免提前创建大量未被使用的日志文件，减少资源占用。

内容的提问来源于stack exchange，提问作者Hauke