本文共 3612 字，大约阅读时间需要 12 分钟。

Log4j日志配置指南

Log4j是Apache开源项目，通过它我们可以灵活控制日志信息的输出目的地、格式和级别，为开发和调试提供强大支持。本文将详细介绍Log4j的使用方法。

一、Log4j概述

Log4j通过定义日志信息的级别、输出目的地和格式，帮助开发者更好地管理和控制日志输出。其主要特点包括：

Log4j的核心组件包括：

• 日志级别：从高到低依次为DEBUG、INFO、WARN、ERROR、FATAL。
• 输出目的地：如ConsoleAppender（控制台）、FileAppender（文件）等。
• 输出格式：通过PatternLayout或其他布局类定制日志显示内容。

二、Log4j配置文件

Log4j支持通过配置文件或代码进行配置。以下是使用properties格式配置文件的常用方法。

1. 配置根Logger

配置文件中，根Logger的语法格式如下：

log4j.rootLogger=LEVEL, AppenderName, AppenderName, …

其中：

• LEVEL：指定日志记录的最低级别，选项包括DEBUG、INFO、WARN、ERROR、FATAL、OFF和ALL。
• AppenderName：指定日志信息输出的目的地Appender。

2. 配置Appender

每个Appender的配置方式如下：

log4j.appender.AppenderName=org.apache.log4j.AppenderClasslog4j.appender.AppenderName.Option1=OptionValue1...log4j.appender.AppenderName.Option=OptionValueN

Log4j提供多种Appender选项，如：

• ConsoleAppender：将日志输出到控制台。
• FileAppender：将日志输出到指定文件。
• DailyRollingFileAppender：每天产生一个新的日志文件。
• RollingFileAppender：当文件达到指定大小时，自动滚动。

3. 配置日志布局

日志布局的配置方式如下：

log4j.appender.AppenderName.layout=org.apache.log4j.LayoutClasslog4j.appender.AppenderName.layout.Option1=LayoutOptionValue1...log4j.appender.AppenderName.layout.Option=LayoutOptionValueN

Log4j提供多种布局类，如PatternLayout（自定义格式）、HTMLLayout（HTML表格形式）等。

三、日志输出格式设置

在配置文件中，可以通过ConversionPattern自定义日志输出格式。常用格式符号包括：

• %p：输出日志级别（如DEBUG、INFO）。
• %d：输出日期和时间（可定制格式）。
• %r：输出应用启动到日志生成的时间戳。
• %c：输出日志所属的类别。
• %t：输出生成日志的线程名。
• %l：输出代码中的行、列和方法信息。
• %x：输出与当前线程相关的嵌套诊断环境（NDC）。

例如：

log4j.appender.CONSOLE.layout.ConversionPattern=%-4r [%t] %37c %3x - %m%n

四、在程序中使用Log4j

1. 导入依赖

在开发程序中，需要导入以下依赖文件：

• commons-logging.jar
• logging-log4j-1.2.9.jar

将配置文件log4j.properties放置于项目的根目录或src目录下。

2. 获取记录器

使用Log4j获取记录器：

public static Logger getLogger(String name) {    return LoggerFactory.getLogger(name);}

或者（推荐）：

private static Log logger = LogFactory.getLog(YourClass.class);

3. 插入日志信息

在程序中使用不同级别的日志记录方法：

Logger.debug("This is a debug message");Logger.info("This is an info message");Logger.warn("This is a warning message");Logger.error("This is an error message");

五、Log4j高级配置示例

以下是Log4j的高级配置示例，涵盖多种Appender和布局设置。

1. 控制台Appender

log4j.rootLogger=DEBUG, CONSOLE, A1, imlog4j.appender.CONSOLE=org.apache.log4j.ConsoleAppenderlog4j.appender.CONSOLE.Threshold=DEBUGlog4j.appender.CONSOLE.Target=System.outlog4j.appender.CONSOLE.layout=org.apache.log4j.PatternLayoutlog4j.appender.CONSOLE.layout.ConversionPattern=[framework]%d - %c - %4r [%t] %5p %c %x - %m%n

2. 文件Appender

log4j.appender.FILE=org.apache.log4j.FileAppenderlog4j.appender.FILE.File=mylog.txtlog4j.appender.FILE.Append=falselog4j.appender.FILE.layout=org.apache.log4j.PatternLayoutlog4j.appender.FILE.layout.ConversionPattern=[framework]%d - %c - %4r [%t] %5p %c %x - %m%n

3. 滚动文件Appender

log4j.appender.ROLLING_FILE=org.apache.log4j.RollingFileAppenderlog4j.appender.ROLLING_FILE.Threshold=ERRORlog4j.appender.ROLLING_FILE.File=rolling.loglog4j.appender.ROLLING_FILE.Append=truelog4j.appender.ROLLING_FILE.MaxFileSize=10KBlog4j.appender.ROLLING_FILE.MaxBackupIndex=1log4j.appender.ROLLING_FILE.layout=org.apache.log4j.PatternLayoutlog4j.appender.ROLLING_FILE.layout.ConversionPattern=[framework]%d - %c - %4r [%t] %5p %c %x - %m%n

4. 邮件Appender

log4j.appender.MAIL=org.apache.log4j.net.SMTPAppenderlog4j.appender.MAIL.Threshold=FATALlog4j.appender.MAIL.BufferSize=10log4j.appender.MAIL.From=web@example.comlog4j.appender.MAIL.SMTPHost=smtp.example.comlog4j.appender.MAIL.Subject=Log4J Messagelog4j.appender.MAIL.To=web@example.comlog4j.appender.MAIL.layout=org.apache.log4j.PatternLayoutlog4j.appender.MAIL.layout.ConversionPattern=[framework]%d - %c - %4r [%t] %5p %c %x - %m%n

通过以上配置，您可以根据实际需求灵活配置Log4j，实现对日志信息的精确控制。

转载地址：http://jdufk.baihongyu.com/