Log4j2如何基于MDC键值将指定日志路由到对应文件？

兄弟，你选的方向完全没错——用Log4j2的RoutingAppender搭配MDC就是实现这个需求的标准方案！不过看你的情况，应该是配置里漏了几个关键环节，才导致路由没生效，日志全跑到默认文件里了。我帮你把问题捋清楚，再给你一个能直接用的配置：

你当前配置的核心问题 #

最可能的原因是你没把RoutingAppender关联到Logger上——Log4j2不会自动启用定义的Appender，必须在<Loggers>节点里明确引用它，否则这个路由Appender根本不会工作，自然不会创建对应的日志文件。

另外，你的配置里也没处理默认情况，而且变量引用的写法可能需要调整，确保MDC值能被正确解析。

修正后的完整配置示例 #

下面是符合你需求的log4j2.xml配置：既能把所有日志写入统一文件，又能根据MDC的log-route键把指定日志路由到对应文件：

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="INFO">
    <Properties>
        <!-- 定义日志格式，包含MDC的log-route字段 -->
        <Property name="newPattern">%d %-5p %X{log-route} [%t] %c{1.} - %m%n</Property>
        <Property name="logDir">log</Property>
    </Properties>

    <Appenders>
        <!-- 1. 默认统一日志文件：所有日志都会写入这里 -->
        <RollingRandomAccessFile name="DefaultRollingFile" fileName="${logDir}/app.log"
                                 filePattern="${logDir}/app.log.%i">
            <PatternLayout pattern="${newPattern}"/>
            <Policies>
                <SizeBasedTriggeringPolicy size="50 MB"/>
            </Policies>
            <DefaultRolloverStrategy max="100"/>
        </RollingRandomAccessFile>

        <!-- 2. 基于MDC路由的Appender：根据log-route值分发日志 -->
        <Routing name="RoutingAppender">
            <!-- 注意这里的写法：$${ctx:log-route}，第一个$是转义，确保能正确读取MDC值 -->
            <Routes pattern="$${ctx:log-route}">
                <!-- 当log-route为EMAIL时，输出到email专属日志 -->
                <Route key="EMAIL">
                    <RollingRandomAccessFile
                        name="EMAILRollingFile"
                        fileName="${logDir}/email/email.log"
                        filePattern="${logDir}/email/email.log.%i">
                        <PatternLayout pattern="${newPattern}"/>
                        <Policies>
                            <OnStartupTriggeringPolicy/>
                            <SizeBasedTriggeringPolicy size="50 MB"/>
                        </Policies>
                        <!-- 只有当有对应日志时才创建文件，避免空文件 -->
                        <property name="createOnDemand">true</property>
                        <DefaultRolloverStrategy fileIndex="min" max="100"/>
                    </RollingRandomAccessFile>
                </Route>

                <!-- 当log-route为DB时，输出到DB专属日志 -->
                <Route key="DB">
                    <RollingRandomAccessFile
                        name="DBRollingFile"
                        fileName="${logDir}/db/db.log"
                        filePattern="${logDir}/db/db.log.%i">
                        <PatternLayout pattern="${newPattern}"/>
                        <Policies>
                            <OnStartupTriggeringPolicy/>
                            <SizeBasedTriggeringPolicy size="50 MB"/>
                        </Policies>
                        <property name="createOnDemand">true</property>
                        <DefaultRolloverStrategy fileIndex="min" max="100"/>
                    </RollingRandomAccessFile>
                </Route>

                <!-- 默认路由：如果没有log-route键或者匹配不到上面的key，这里可以什么都不做（因为我们已经有默认Appender处理所有日志了） -->
                <Route key="$${ctx:log-route}"/>
            </Routes>
        </Routing>
    </Appenders>

    <Loggers>
        <Root level="info">
            <!-- 关键！同时引用默认Appender和路由Appender，确保所有日志进统一文件，符合条件的额外进专属文件 -->
            <AppenderRef ref="DefaultRollingFile"/>
            <AppenderRef ref="RoutingAppender"/>
        </Root>
    </Loggers>
</Configuration>

Java代码里的注意事项 #

1. 设置MDC后一定要清理：线程池里的线程会复用MDC值，如果不清理，后续请求可能会继承旧的log-route值，导致日志路由错误。务必在finally块里移除MDC键：

MDC.put("log-route", "EMAIL");
try {
    // 执行邮件相关业务逻辑，打印日志
    logger.info("开始处理邮件发送请求");
} finally {
    // 清理MDC，避免线程污染
    MDC.remove("log-route");
}

2. 如果是Spring等框架环境，可以用拦截器、过滤器或者AOP来统一处理MDC的设置和清理，避免重复代码。

验证效果 #

配置好之后，当你设置MDC.put("log-route","EMAIL")并打印日志时，这条日志会同时出现在app.log和log/email/email.log里；DB相关的日志同理会出现在app.log和log/db/db.log里，而且专属日志文件会在首次有对应日志时自动创建。

备注：内容来源于stack exchange，提问作者Red--Man