Log4j Properties 配置项详细说明

Log4j Properties 配置项详细说明

1. 核心配置项说明

• 根日志记录器：定义全局日志级别和输出目标
  log4j.rootLogger = [级别], appender1, appender2,...
• Appender 定义：指定日志输出目标（控制台、文件等）
  log4j.appender.[名称].[属性] = 值
• 布局配置：定义日志输出格式
  log4j.appender.[名称].layout = 布局类

---

2. 完整配置示例（Log4j 1.x）

# 根日志配置：DEBUG级别，输出到控制台(console)和文件(file)
log4j.rootLogger=DEBUG, console, file# 控制台Appender配置
log4j.appender.console=org.apache.log4j.ConsoleAppender
log4j.appender.console.Target=System.out  # 输出到标准输出
log4j.appender.console.layout=org.apache.log4j.PatternLayout
log4j.appender.console.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} %-5p %c:%L - %m%n# 文件Appender配置
log4j.appender.file=org.apache.log4j.RollingFileAppender
log4j.appender.file.File=logs/app.log  # 日志文件路径
log4j.appender.file.MaxFileSize=10MB   # 滚动文件最大尺寸
log4j.appender.file.MaxBackupIndex=10 # 最大备份文件数
log4j.appender.file.layout=org.apache.log4j.PatternLayout
log4j.appender.file.layout.ConversionPattern=%d [%t] %-5p %c - %m%n# 指定特定包的日志级别（覆盖根配置）
log4j.logger.com.example=INFO

3. 配置项表格总结

配置项	描述	示例	说明
log4j.rootLogger	定义根日志级别和Appender列表	log4j.rootLogger=DEBUG, console, file	必须配置，支持OFF, FATAL, ERROR, WARN, INFO, DEBUG, ALL
log4j.appender.name	指定Appender类型	log4j.appender.console=org.apache.log4j.ConsoleAppender	常用类型：ConsoleAppender, FileAppender, RollingFileAppender
log4j.appender.name.Target	控制台Appender的输出目标（System.out或System.err）	log4j.appender.console.Target=System.out	默认为System.out
log4j.appender.name.File	文件Appender的输出路径	log4j.appender.file.File=logs/app.log	相对路径基于应用工作目录
log4j.appender.name.layout	指定日志格式布局类	log4j.appender.file.layout=org.apache.log4j.PatternLayout	常用布局：PatternLayout, HTMLLayout
log4j.appender.name.layout.ConversionPattern	定义日志格式字符串（PatternLayout专用）	%d{yyyy-MM-dd HH:mm:ss} %-5p %c:%L - %m%n	%d日期，%p级别，%m消息等
log4j.appender.RollingFile.MaxFileSize	滚动文件的最大文件大小	log4j.appender.file.MaxFileSize=10MB	超过此值触发滚动
log4j.logger.package	指定包的日志级别（覆盖根配置）	log4j.logger.com.example=INFO	可精确控制特定模块的日志输出

---

关键说明

1. 日志级别优先级：OFF > FATAL > ERROR > WARN > INFO > DEBUG > TRACE > ALL
   • 高级别（如INFO）会过滤掉低级别（如DEBUG）的日志
2. Appender类型：
   • ConsoleAppender：输出到控制台
   • FileAppender：输出到文件（不滚动）
   • RollingFileAppender：支持文件滚动（按大小或时间）
3. PatternLayout 格式符：
   • %d：日期
   • %p：日志级别
   • %c：日志记录器名称
   • %L：行号
   • %m：日志消息
   • %n：换行符

注意：Log4j 2.x 配置语法不同，建议参考官方文档确认版本差异。