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 级别:在
下定义,决定该 Logger 实例“愿意发出”什么级别的日志 -
Appender 的过滤器(Filter):在
内配置,决定“接收并输出”什么级别的日志
两者取交集。常见组合示例:
- Logger 设为
level="DEBUG",Console Appender 用→ 控制台只显示 INFO 及以上,但 Logger 仍可记录 DEBUG 日志供文件 Appender 使用 - RollingFile Appender 配
,专门收集告警和错误,避免 info 日志挤占磁盘 - 根 Logger(
)设level="INFO",表示所有未显式声明的 Logger 默认按 INFO 处理
按包或类精细化控制日志级别
不用所有日志都一个级别。可通过自定义 节点实现分层管理:
- 让第三方库少打日志:
- 对核心业务类开启 DEBUG:
-
additivity="false"表示该 Logger 不再继承父 Logger(如 Root)的 Appender,避免日志重复输出
这种配置放在 标签下,紧挨着 即可生效。










