Java中如何用Log4j记录日志信息-Java-PHP中文网

Java中如何用Log4j记录日志信息

冰火之心

发布： 2025-06-29 17:58:01

原创

263人浏览过

log4j的使用主要包括配置环境和调用api记录日志。1. 配置log4j环境可通过log4j.properties或log4j.xml文件实现，其中xml结构更清晰，便于管理复杂配置；2. 在java代码中使用log4j需引入依赖并获取logger实例，随后调用相应log方法记录日志；3. log4j的日志级别从低到高依次为debug、info、warn、error、fatal，设置级别后仅记录等于或高于该级别的日志；4. 自定义日志格式通过修改conversionpattern参数实现，可灵活调整输出内容如时间、级别、类名、行号等；5. log4j 2相较1.x版本具备性能提升、自动重载配置、支持多种配置格式、插件架构及更强大的过滤功能等优势，但迁移时可能需要调整代码。配置文件应放置在classpath下以确保log4j能够识别，通常位于src/main/resources目录。

Java中如何用Log4j记录日志信息

Java中，使用Log4j记录日志信息主要涉及配置Log4j环境，然后在代码中调用Log4j的API进行日志记录。简单来说，就是先告诉Log4j你想把日志记在哪里，记什么级别的，然后让代码按照你的要求记录。

配置Log4j，使用Logger实例，设置日志级别，调用相应的log方法。

如何配置Log4j环境？

配置Log4j主要有两种方式：通过log4j.properties文件或者log4j.xml文件。个人更偏向于log4j.xml，因为XML结构更清晰，方便管理复杂的配置。

立即学习“Java免费学习笔记（深入）”；

log4j.properties配置示例：

log4j.rootLogger=DEBUG, console, file

log4j.appender.console=org.apache.log4j.ConsoleAppender
log4j.appender.console.layout=org.apache.log4j.PatternLayout
log4j.appender.console.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} %-5p %c{1}:%L - %m%n

log4j.appender.file=org.apache.log4j.RollingFileAppender
log4j.appender.file.File=myApp.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{yyyy-MM-dd HH:mm:ss} %-5p %c{1}:%L - %m%n

登录后复制

这段配置定义了一个根logger，级别为DEBUG，并将日志输出到控制台和文件。 console appender使用ConsoleAppender，file appender使用RollingFileAppender，它可以自动切割日志文件。

log4j.xml配置示例：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">

  <appender name="console" class="org.apache.log4j.ConsoleAppender">
    <layout class="org.apache.log4j.PatternLayout">
      <param name="ConversionPattern" value="%d{yyyy-MM-dd HH:mm:ss} %-5p %c{1}:%L - %m%n" />
    </layout>
  </appender>

  <appender name="file" class="org.apache.log4j.RollingFileAppender">
    <param name="File" value="myApp.log" />
    <param name="MaxFileSize" value="10MB" />
    <param name="MaxBackupIndex" value="10" />
    <layout class="org.apache.log4j.PatternLayout">
      <param name="ConversionPattern" value="%d{yyyy-MM-dd HH:mm:ss} %-5p %c{1}:%L - %m%n" />
    </layout>
  </appender>

  <root>
    <level value="DEBUG" />
    <appender-ref ref="console" />
    <appender-ref ref="file" />
  </root>
</log4j:configuration>

登录后复制

XML的配置方式和properties文件表达的是同样的意思，但是结构更清晰。

为了让Log4j找到这些配置文件，你需要将它们放在classpath下。通常，放在src/main/resources目录下即可。

如何在Java代码中使用Log4j记录日志？

首先，你需要引入Log4j的依赖。如果你使用Maven，可以在pom.xml文件中添加：

<dependency>
    <groupId>log4j</groupId>
    <artifactId>log4j</artifactId>
    <version>1.2.17</version>
</dependency>

登录后复制

然后，在你的Java代码中，你可以这样使用Log4j：

import org.apache.log4j.Logger;

public class MyClass {
    private static final Logger logger = Logger.getLogger(MyClass.class);

    public void doSomething() {
        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.");
        logger.fatal("This is a fatal message.");

        try {
            // 一些可能会抛出异常的代码
            int result = 10 / 0;
        } catch (Exception e) {
            logger.error("发生异常", e); // 记录异常信息
        }
    }

    public static void main(String[] args) {
        MyClass myClass = new MyClass();
        myClass.doSomething();
    }
}

登录后复制

这段代码首先获取一个Logger实例，然后使用不同级别的log方法记录日志。如果配置文件中设置的级别是DEBUG，那么所有级别的日志都会被记录。如果设置的是INFO，那么DEBUG级别的日志就不会被记录。

Log4j的日志级别有哪些，有什么区别？

Log4j定义了几个标准的日志级别，从低到高分别是：

DEBUG: 调试信息，用于开发过程中详细的输出。
INFO: 普通信息，用于记录程序运行状态。
WARN: 警告信息，表示可能存在潜在的问题，但不影响程序运行。
ERROR: 错误信息，表示程序发生了错误，需要关注。
FATAL: 致命错误，表示程序发生了严重的错误，可能导致程序崩溃。

设置日志级别，实际上是设置一个阈值。只有高于或等于该级别的日志才会被记录。比如，设置级别为INFO，那么只有INFO、WARN、ERROR和FATAL级别的日志会被记录，DEBUG级别的日志会被忽略。

如何自定义Log4j的日志格式？

自定义日志格式是通过修改ConversionPattern来实现的。在log4j.properties或者log4j.xml文件中，你可以找到ConversionPattern这个参数。

一些常用的格式化选项：

%d{yyyy-MM-dd HH:mm:ss}: 日期和时间
%-5p: 日志级别（左对齐，5个字符宽度）
%c{1}: 类名（只显示类名的第一个部分）
%L: 行号
%m: 日志消息
%n: 换行符

例如，如果你想让日志格式更简洁，只显示时间和日志级别和消息，你可以这样配置：

<param name="ConversionPattern" value="%d{HH:mm:ss} %-5p - %m%n" />

登录后复制

这样，你的日志就会像这样：

10:20:30 INFO  - This is an info message.
10:20:30 WARN  - This is a warning message.

登录后复制

Log4j 2相比Log4j 1.x有哪些优势？

虽然Log4j 1.x 已经停止维护，但仍然有很多项目在使用。Log4j 2是它的继任者，提供了很多改进。

性能提升: Log4j 2 在性能方面做了大量的优化，尤其是在异步日志记录方面，性能提升非常明显。
自动重载配置: Log4j 2 可以自动检测配置文件的变化并重新加载，无需重启应用。
支持多种配置格式: Log4j 2 支持properties、XML、JSON和YAML等多种配置格式。
插件架构: Log4j 2 使用插件架构，可以方便地扩展功能。
更强大的过滤功能: Log4j 2 提供了更强大的过滤功能，可以根据各种条件过滤日志。

尽管Log4j 2有很多优点，但迁移到Log4j 2 可能需要修改代码，因为API有所不同。所以，在选择使用哪个版本时，需要根据项目的具体情况进行评估。

以上就是Java中如何用Log4j记录日志信息的详细内容，更多请关注php中文网其它相关文章！