log4j2 日志级别由 Logger 和 Appender 共同控制,优先级从高到低为 OFF、FATAL、ERROR、WARN、INFO、DEBUG、TRACE、ALL;全局 status 属性仅影响 log4j2 自身内部日志,业务日志级别需通过 Logger 的 level 与 Appender 的 ThresholdFilter 协同设定,并支持按包 / 类精细化配置。

log4j2.xml 中的日志级别不是写死在某一行,而是通过 Logger 和 Appender 的组合控制,核心在于“谁(Logger)用什么规则(Filter/Level)把日志发给哪个目标(Appender)”。级别设置错,要么看不到关键日志,要么被海量 DEBUG 淹没。
日志级别优先级与可选值
log4j2 支持 8 个标准级别,从高到低依次为:
- OFF:关闭所有日志(最高优先级,实际禁用)
- FATAL:严重错误,应用可能已无法继续运行
- ERROR:错误事件,但应用仍可继续运行
- WARN:潜在问题,需关注但非紧急
- INFO:常规运行信息,如服务启动、关键流程完成
- DEBUG:调试信息,开发 / 测试阶段常用
- TRACE:比 DEBUG 更细粒度的跟踪,如方法入参、循环内状态
- ALL:启用所有级别(最低优先级)
注意:级别是 ** 严格有序比较 **。例如,设为 INFO,则只输出 INFO、WARN、ERROR、FATAL 级别日志,DEBUG 及以下被自动忽略。
全局日志级别:Configuration 的 status 属性
这个级别不控制你的业务日志,而是控制 log4j2 自身内部行为日志 (比如配置加载失败、插件初始化异常等):
-
status="WARN"(推荐默认):只输出警告及以上内部信息 -
status="DEBUG"或"TRACE":排查配置问题时开启,能看到 log4j2 加载了哪些 Appender、是否检测到文件变更等详细过程 - 不建议生产环境设为 TRACE,会产生大量无关输出
真正生效的业务日志级别设置方式
业务日志是否输出、输出到哪,由两层控制共同决定:
- Logger 级别 :在
<loggers></loggers>下定义,决定该 Logger 实例“愿意发出”什么级别的日志 - Appender 的过滤器(Filter):在
<appender></appender>内配置,决定“接收并输出”什么级别的日志
两者取交集。常见组合示例:
- Logger 设为
level="DEBUG",Console Appender 用<thresholdfilter level="INFO"></thresholdfilter>→ 控制台只显示 INFO 及以上,但 Logger 仍可记录 DEBUG 日志供文件 Appender 使用 - RollingFile Appender 配
<thresholdfilter level="WARN"></thresholdfilter>,专门收集告警和错误,避免 info 日志挤占磁盘 - 根 Logger(
<root></root>)设level="INFO",表示所有未显式声明的 Logger 默认按 INFO 处理
按包或类精细化控制日志级别
不用所有日志都一个级别。可通过自定义 <logger></logger> 节点实现分层管理:
- 让第三方库少打日志:
<logger name="org.apache.http" level="WARN" additivity="false"></logger> - 对核心业务类开启 DEBUG:
-
additivity="false"表示该 Logger 不再继承父 Logger(如 Root)的 Appender,避免日志重复输出
这种配置放在 <loggers></loggers> 标签下,紧挨着 <root></root> 即可生效。