当前位置：首页 > Java

java 如何记录日志

2026-03-03 12:39:48Java

Java 日志记录方法

Java 提供了多种日志记录框架，每种框架都有其特点和适用场景。以下是常见的日志记录方法：

使用 `java.util.logging`（JUL）

Java 自带的日志框架，无需额外依赖。

import java.util.logging.Logger;

public class LogExample {
    private static final Logger LOGGER = Logger.getLogger(LogExample.class.getName());

    public static void main(String[] args) {
        LOGGER.info("This is an info message");
        LOGGER.warning("This is a warning message");
        LOGGER.severe("This is an error message");
    }
}

使用 Log4j 2

Apache Log4j 2 是一个高性能的日志框架，功能强大且灵活。

添加 Maven 依赖：

<dependency>
 <groupId>org.apache.logging.log4j</groupId>
 <artifactId>log4j-core</artifactId>
 <version>2.20.0</version>
</dependency>

配置文件 log4j2.xml：

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN">
 <Appenders>
     <Console name="Console" target="SYSTEM_OUT">
         <PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
     </Console>
 </Appenders>
 <Loggers>
     <Root level="info">
         <AppenderRef ref="Console"/>
     </Root>
 </Loggers>
</Configuration>

代码示例：


import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.Logger;

public class LogExample { private static final Logger LOGGER = LogManager.getLogger(LogExample.class);

public static void main(String[] args) {
    LOGGER.info("This is an info message");
    LOGGER.error("This is an error message");
}

}


#### 使用 SLF4J + Logback

SLF4J 是日志门面，Logback 是实现，组合使用可以提供更好的灵活性和性能。

1. 添加 Maven 依赖：
```xml
<dependency>
    <groupId>ch.qos.logback</groupId>
    <artifactId>logback-classic</artifactId>
    <version>1.4.7</version>
</dependency>

配置文件 logback.xml：

<configuration>
 <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
     <encoder>
         <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
     </encoder>
 </appender>
 <root level="info">
     <appender-ref ref="STDOUT" />
 </root>
</configuration>

代码示例：


import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class LogExample { private static final Logger LOGGER = LoggerFactory.getLogger(LogExample.class);

public static void main(String[] args) {
    LOGGER.info("This is an info message");
    LOGGER.error("This is an error message");
}

}



#### 日志级别

常见的日志级别从低到高包括：
- TRACE
- DEBUG
- INFO
- WARN
- ERROR

根据需求选择合适的日志级别，避免过度记录。

#### 日志记录最佳实践

- 使用适当的日志级别，避免在生产环境中记录过多 DEBUG 或 TRACE 日志。
- 在日志消息中包含上下文信息，便于排查问题。
- 避免在日志中记录敏感信息，如密码或用户隐私数据。
- 定期归档和清理日志文件，防止磁盘空间被占满。

以上方法可以根据项目需求选择适合的日志框架和配置方式。

java 如何记录日志