Log4j2的XML配置通过Appenders定义日志输出目标,Loggers控制日志级别与处理行为,结合使用可实现灵活的日志管理。

Log4j2 的 XML 配置文件是控制日志输出格式、目标和级别的重要方式。通过合理配置 Appenders 和 Loggers,可以灵活管理应用程序的日志行为。下面详细介绍如何编写 Log4j2 的 XML 配置文件,并说明 Appenders 与 Loggers 的作用及配置方法。
配置文件基本结构
Log4j2 的 XML 配置文件通常命名为 log4j2.xml,放置在项目的 classpath 下(如 src/main/resources)。其根元素为 Configuration,常用属性包括 status(用于输出内部日志信息)和 monitorInterval(自动重载配置的时间间隔,单位秒)。
...
...
status="WARN" 表示只输出 Log4j2 自身的警告及以上级别的内部日志,避免干扰应用日志。monitorInterval="30" 表示每 30 秒检查一次配置文件是否变更,若有则自动重新加载。
Appenders 配置:定义日志输出目的地
Appenders 决定日志输出到哪里,比如控制台、文件、数据库或远程服务。常见的 Appender 类型有 Console、File、RollingFile 等。
1. ConsoleAppender:输出到控制台
- name:Appender 的唯一标识名
- target:可选 SYSTEM_OUT 或 SYSTEM_ERR
- PatternLayout:定义日志输出格式
2. FileAppender:输出到固定文件
- fileName:指定日志文件路径
- 日志会一直追加到该文件,不会自动滚动
3. RollingFileAppender:按条件滚动日志文件
- filePattern:定义归档文件命名规则,支持日期和序号
- Policies:触发滚动的策略,如按时间或大小
- DefaultRolloverStrategy max="20":最多保留 20 个归档文件
Loggers 配置:控制日志记录行为
Loggers 负责接收日志事件,并决定是否处理以及使用哪些 Appenders 输出。分为根 Logger(Root Logger)和自定义 Logger。
1. Root Logger:默认日志处理器
- level:设置日志级别,常见值有 trace、debug、info、warn、error
- AppenderRef:引用已定义的 Appender 名称
所有未单独配置的类都会使用 Root Logger 的设置。
2. 自定义 Logger:针对特定包或类
- name:通常是 Java 包名或类名
- level:此 Logger 的日志级别
- additivity="false":表示不继承 Root Logger 的 Appenders,避免重复输出
例如,将 service 包下的日志设为 debug 级别,并只输出到文件,而其他包仍使用 root 的配置。
完整配置示例
这个配置实现了:
- 控制台输出 info 及以上日志
- 所有日志写入滚动文件
- dao 包下 debug 日志也记录到文件,且不重复输出到控制台
- 每天或文件超过 10MB 时自动归档,最多保留 20 个备份
基本上就这些。理解 Appenders 和 Loggers 的分工与协作,就能写出满足大多数场景的日志配置。










