Log4j2 配置多个 File Appender 时日志完全不输出，通常因 Root Logger 未正确引用全部 Appender 或缺少过滤器导致日志被静默丢弃；本文详解如何通过 ThresholdFilter 实现按级别分流写入不同文件。
log4j2 配置多个 file appender 时日志完全不输出，通常因 root logger 未正确引用全部 appender 或缺少过滤器导致日志被静默丢弃；本文详解如何通过 `thresholdfilter` 实现按级别分流写入不同文件。
在 Log4j2 中，为同一 Logger（如 Root）配置多个 Appender 并非简单叠加即可生效。关键在于：每个 Appender 默认接收所有匹配 Logger 级别的日志事件，但若未显式设置过滤策略，多个 Appender 可能因内部处理冲突或日志事件被前置 Appender 消费而“消失”——更常见的情况是：Root Logger 仅声明了一个 AppenderRef，却误以为添加第二个 <root></root> 标签就能启用双输出，这会导致配置解析失败或后一个 Root 覆盖前一个，最终无日志生成。
正确做法是：单个 Root Logger 同时引用多个 Appender，并为每个 Appender 配置独立的 ThresholdFilter，实现按日志级别精准分流。例如，将 INFO 及以上日志写入 history.log，DEBUG 日志（含 INFO/WARN/ERROR）单独写入 debug.log：
<Configuration status="WARN">
<Appenders>
<!-- 历史操作日志：仅记录 INFO 及以上 -->
<File name="LogHistoryFile" fileName="logs/history.${date:yyyy-MM-dd}.log">
<PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
<ThresholdFilter level="INFO" onMatch="ACCEPT" onMismatch="DENY"/>
</File>
<!-- 调试日志：记录 DEBUG 及以上（含 INFO、WARN、ERROR） -->
<File name="LogDebugFile" fileName="logs/debug.${date:yyyy-MM-dd}.log">
<PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
<ThresholdFilter level="DEBUG" onMatch="ACCEPT" onMismatch="DENY"/>
</File>
</Appenders>
<Loggers>
<!-- 单一 Root Logger，同时引用两个 Appender -->
<Root level="debug">
<AppenderRef ref="LogHistoryFile"/>
<AppenderRef ref="LogDebugFile"/>
</Root>
</Loggers>
</Configuration>⚠️ 关键注意事项：
-
禁止重复定义
<root></root>：Log4j2 不支持多个 Root Logger 标签，否则配置无效或报错； -
onMismatch="DENY"不可省略：确保不匹配阈值的日志被明确拒绝，避免意外透传； -
确保日志目录可写：Tomcat 运行用户需对
logs/目录有写权限，建议使用绝对路径或${sys:catalina.base}/logs/提升健壮性； -
验证配置加载：启动时观察控制台是否输出
INFO StatusLogger Successfully started Log4j2，并检查status="WARN"是否升级为DEBUG以排查解析问题。
通过该配置，您在 Servlet 中调用 logger.info("Login succeeded...") 将同时写入 history.log 和 debug.log，而 logger.debug("Further information...") 仅写入 debug.log——真正实现多通道、分级别的日志持久化。
