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 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"></patternlayout><thresholdfilter level="INFO" onmatch="ACCEPT" onmismatch="DENY"></thresholdfilter></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"></patternlayout><thresholdfilter level="DEBUG" onmatch="ACCEPT" onmismatch="DENY"></thresholdfilter></file></appenders><loggers><!-- 单一 Root Logger，同时引用两个 Appender --><root level="debug"><appenderref ref="LogHistoryFile"></appenderref><appenderref ref="LogDebugFile"></appenderref></root></loggers></configuration>
⚠️ 关键注意事项：
-
禁止重复定义
-
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——真正实现多通道、分级别的日志持久化。
