一、根日志器（Root Logger）基础定义

在 Log4j 体系中，根日志器是所有组件的顶层入口。其配置逻辑遵循特定的声明式语法，用于全局确立默认的日志记录阈值并将事件路由至预定义的处理节点。

log4j.rootLogger = [ 优先级 ], 输出名，输出名，…

上述配置的语义为：将不低于指定优先级的日志记录分发至后续列出的各个输出目标。例如，若设定为 ERROR，则仅向控台和文件发送严重错误及以上的事件：

设定含义：
ERROR 级别及其以上的日志内容将被同步发送至标准控制终端及特定文本文件存储区。

二、输出端（Appender）类型选型

在配置文件中定义的各个输出目标名称，对应具体的处理实现类。常见的内置组件包括：

• ConsoleAppender：直接打印至标准系统控制流（Stdout/Stderr），常用于开发调试阶段。
• FileAppender：单向追加写入至单一静态文件，适用于小型应用或临时测试。
• DailyRollingFileAppender：依据日期滚动生成日志，每日新文件，便于归档管理。
• RollingFileAppender：基于文件大小阈值进行滚动，满额即创建新文件，适合高并发场景。
• WriterAppender：将日志流定向至任意指定的流对象。

在实际生产环境中，通常组合使用控制台监控与定期滚动的文件归档策略。针对海量日志场景，建议启用按大小轮转的 Appender；对于常规业务，按日切分的归档方式更利于查阅。

综合配置示例

以下是一个典型的 `log4j.properties` 配置文件片段，演示了如何同时配置多种输出源：

log4j.rootLogger=DEBUG, OutPutConsole, StdFile, DateFile, SizeRollFile

# --- 控制台输出配置 ---
log4j.appender.OutPutConsole=org.apache.log4j.ConsoleAppender
log4j.appender.OutPutConsole.layout=org.apache.log4j.PatternLayout
log4j.appender.OutPutConsole.layout.ConversionPattern=%d [%t] %-5p [%c] - %m%n

# --- 静态文件写入配置 ---
log4j.appender.StdFile = org.apache.log4j.FileAppender
log4j.appender.StdFile.File = /opt/logs/main_system.log
log4j.appender.StdFile.layout = org.apache.log4j.PatternLayout
log4j.appender.StdFile.layout.ConversionPattern =%d [%t] %-5p [%c] - %m%n

# --- 按日期轮转配置 ---
log4j.appender.DateFile = org.apache.log4j.DailyRollingFileAppender
log4j.appender.DateFile.File = /opt/logs/archive_today.log
log4j.appender.DateFile.layout = org.apache.log4j.PatternLayout
log4j.appender.DateFile.layout.ConversionPattern =%d [%t] %-5p [%c] - %m%n
 
# --- 按大小轮转配置 ---
log4j.appender.SizeRollFile = org.apache.log4j.RollingFileAppender
log4j.appender.SizeRollFile.File = /opt/logs/sized_log.log
log4j.appender.SizeRollFile.MaxFileSize=10MB
log4j.appender.SizeRollFile.MaxBackupIndex=10
log4j.appender.SizeRollFile.layout = org.apache.log4j.PatternLayout
log4j.appender.SizeRollFile.layout.ConversionPattern =%d [%t] %-5p [%c] - %m%n

其中关键属性说明如下：

• MaxFileSize：触发滚动的大小上限（单位 MB 或 KB），需根据磁盘空间规划调整。
• MaxBackupIndex：保留的历史备份文件数量，超出部分将被自动删除以释放容量。

测试代码验证

配合以下 Java 客户端代码执行日志生成逻辑：

package com.tech.samples;

import org.apache.log4j.Logger;

public class LogRunner {
    private static Logger logger = Logger.getLogger(LogRunner.class);
    
    public static void main(String[] args) {
        int iteration = 0;
        for (iteration = 1; iteration <= 5; iteration++) {
            logger.info("常规状态通知 #" + iteration);
            logger.debug("底层细节追踪 #" + iteration);
            logger.error("功能异常报告 #" + iteration);
            logger.warn("潜在风险预警 #" + iteration);
            logger.fatal("致命崩溃 #" + iteration);
            
            // 异常堆栈测试
            logger.error("参数校验失败", new IllegalArgumentException("Invalid input argument"));
        }
    }
}

运行后观察生成的日志文件：日期归档文件应包含当日所有条目；大小轮转文件因达到阈值会生成多个历史切片；控制台即时刷新输出内容。具体表现取决于各 Appender 的路径配置。

三、布局（Layout）格式化控制

日志的具体呈现形态由 Layout 类决定。Log4j 支持以下几种布局模式：

1. HTMLLayout：生成 HTML 表格格式，便于 Web 界面浏览。
2. PatternLayout：高度可定制，通过转换字符串定义字段顺序。
3. SimpleLayout：极简模式，仅显示级别与消息。
4. TTCCLayout：TimeThreadContextClass，包含时间、线程及类别的复杂格式。

重点掌握：PatternLayout

在生产配置中最常使用的是 ConversionPattern 属性。以下是常用转换符说明：

• %m：日志消息正文。
• %n：换行符（适配操作系统差异）。
• %p：当前日志优先级（如 DEBUG、INFO）。
• %t：产生日志的线程名称。
• %l：调用来源，包括类全名及行号。
• %c：所属类目名称（通常是类的全限定名）。
• %d：时间戳，默认为 ISO 格式，也可自定义：%d{yyyy-MM-dd HH:mm:ss}。
• %r：自应用启动起经过的毫秒数。
• %M：调用该方法的名。

配置示例：

#Console  
log4j.appender.OutPutConsole=org.apache.log4j.ConsoleAppender  
log4j.appender.OutPutConsole.layout=org.apache.log4j.PatternLayout
log4j.appender.OutPutConsole.layout.ConversionPattern=%d [%t] %-5p [%c] - %m%n   

注：-5 表示左对齐并预留 5 个字符宽度，不足补空格，确保输出对齐整齐。若省略该数字，日志级别单词长度不一会导致视觉错乱。

四、Threshold 过滤属性

当需要对不同级别的消息分离存储时，可利用 Threshold 属性对单个 Appender 进行二次过滤。虽然 Root Logger 设置了总阈值，但每个 Appender 可以独立设定最低准入标准。

例如，意图将所有 Debug 信息存入 debug 日志，仅将 Error 写入 error 日志：

log4j.rootLogger=DEBUG, Console ,DFile ,EFILE

# Console 保持原有配置
log4j.appender.Console=org.apache.log4j.ConsoleAppender  
log4j.appender.Console.layout=org.apache.log4j.TTCCLayout

# DEBUG 专用文件
log4j.appender.DFile = org.apache.log4j.FileAppender
log4j.appender.DFile.File = D:/logs/DETAILS.log
log4j.appender.DFile.layout = org.apache.log4j.PatternLayout
log4j.appender.DFile.Threshold = DEBUG
log4j.appender.DFile.layout.ConversionPattern =%d [%t] %-5p [%c] - %m%n

# ERROR 专用文件
log4j.appender.EFILE = org.apache.log4j.FileAppender
log4j.appender.EFILE.File = D:/logs/CRITICAL.log
log4j.appender.EFILE.layout = org.apache.log4j.PatternLayout
log4j.appender.EFILE.layout.ConversionPattern =%d [%t] %-5p [%c] - %m%n
log4j.appender.EFILE.Threshold = ERROR

逻辑约束： 若 Root Logger 设定的级别高于某个 Appender 的 Threshold，则该 Appender 不会拦截该级别的日志（因为 Root 已拒绝）。反之，Root 允许的低级别日志进入 Appender 后，需满足 Appender 自身的 Threshold 才能生效。例如 Root 设为 DEBUG，而 EFILE 设为 ERROR，则只有 ERROR 及以上的日志能写入 EFILE。

五、Append 覆盖行为控制

文件 Appender 默认具备追加模式（Append=true），即反复执行程序时在新行写入。若设置 Append=false，程序每次运行时将截断旧内容并从头开始书写。

应用场景：若仅需保存最后一次运行结果，可显式关闭追加功能。

#DEBUGFile
log4j.appender.DFile = org.apache.log4j.FileAppender
log4j.appender.DFile.File = D:/logs/RESET.log
# ...
log4j.appender.DFile.Append = false

此时无论代码重复执行多少次，RESET.log 始终只保留最近一次运行的日志记录，前序内容将被清空。