JAVA Log 日志级别和使用配置示例

本文主要是介绍JAVA Log 日志级别和使用配置示例，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

《JAVALog日志级别和使用配置示例》本文介绍了Java中主流的日志框架,包括Logback和Log4j2,并详细解释了日志级别及其使用场景,同时,还提供了配置示例和使用技巧,如正确的日志记录方...

一、主流日志框架

1. Logback (推荐)

Spring Boot默认日志框架

2. Log4j2

高性能日志框架

3. SLF4J + Logback (最常用组合)

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
public class MyClass {
    private static final Logger logger = LoggerFactory.getLogger(MyClass.class);
}

二、日志级别详解

日志级别从低到高：

级别	描述	使用场景
TRACE	最详细的跟踪信息	方法进入退出、详细流程跟踪
DEBUG	调试信息	开发阶段的调试信息
INFO	重要的运行信息	系统启动、关键业务流程
WARN	警告信息	不影响系统运行的异常情况
ERROR	错误信息	需要关注的处理错误
FATAL	致命错误	导致系统崩溃的错误

级别关系：

TRACE < DEBUG < INFO < WARN < ERROR < FATAL

三、配置示例

1. Logback配置 (logback-spring.xml)

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <!-- 控制台输出 -->
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        &javascriptlt;encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>
    <!-- 文件输出 -->
    <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>logs/app.log</file>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>logs/app.%d{yyyy-MM-dd}.%i.log</fileNamePattern>
            <maxHistory>30</maxHistory>
        </rollingPolicy>
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>
    <!-- 异步日志 -->
    <appender name="ASYNC" class=php"ch.qos.logback.classic.AsyncAppender">
        <appender-ref ref="FILE"/>
        <queueSize>512</queueSize>
    </appender>
    <!-- 日志级别配置 -->
    <root level="INFO">
        <appender-ref ref="CONSOLE"/>
        <appender-ref ref="ASYNC"/>
    </root>
    <!-- 包级别日志 -->
    <logger name="com.example.service" level="DEBUG"/>
    <logger name="org.springframework" level="WARN"/>
</configuration>

2. Log4j2配置

<?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{3编程6} - %msg%n"/>
STVrS        </Console>
        <RollingFile name="File" fileName="logs/app.log"
                     filePattern="logs/app-%d{yyyy-MM-dd}-%i.log">
            <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
            <Policies>
                <TimeBasedTriggeringPolicy/>
                <SizeBasedTriggeringPolicy size="100 MB"/>
            </Policies>
        </RollingFile>
    </Appenders>
    <Loggers>
        <Root level="info">
            <AppenderRef ref="Console"/>
            <AppenderRef ref="File"/>
        </Root>
    </Loggers>
</Configuration>

四编程、使用技巧和最佳实践

1. 正确的日志记录方式

@Service
public class UserService {
    private static final Logger logger = LoggerFactory.getLogger(UserService.class);
    public User getUserById(Long id) {
        // 使用占位符，避免字符串拼接
        logger.debug("查询用户信息, userId: {}", id);
        try {
            User user = userRepository.findById(id);
            if (user != null) {
                logger.info("成功查询用户: {}", user.getUsername());
            } else {
                logger.warn("用户不存在, userId: {}", id);
            }
            return user;
        } catch (Exception e) {
            logger.error("查询用户失败, userId: {}", id, e);
            throw new RuntimeException("查询用户失败", e);
        }
    }
    // 使用条件判断提升性能
    public void processData(List<String> data) {
        if (logger.isDebugEnabled()) {
            logger.debug("处理数据, 数据量: {}, 内容: {}", data.size(), data);
        }
        // 复杂处理逻辑...
    }
}

2. 异常日志记录

public class ExceptionHandlingExample {
    // 不好的方式 - 丢失堆栈信息
    public void badExceptionLogging() {
        try {
            // 业务代码
        } catch (Exception e) {
            logger.error("操作失败: " + e.getMessage()); // 错误！
        }
    }
    // 好的方式 - 完整异常信息
    public void goodExceptionLogging() {
        try {
            // 业务代码
        } catch (BusinessException e) {
            logger.warn("业务异常, 用户ID: {}, 操作: {}", userId, operation, e);
        } catch (Exception e) {
            logger.error("系统异常, 用户ID: {}, 操作: {}", userId, operation, e);
        }
    }
}

3. 性能敏感场景的日志优化

public class PerformanceSensitiveClass {
    public void highPerformanceMethod() {
        // 使用lambda延迟计算，避免不必要的字符串构建
        logger.debug("处理请求参数: {}", () -> buildExpensiveLogMessage());
        // 或者使用条件判断
        if (logger.isDebugEnabled()) {
            logger.debug("详细数据: {}", expensiveDataToString());
        }
    }
    private String buildExpensiveLogMessage() {
        // 构建复杂的日志消息
        return "expensive message";
    }
}

五、环境特定的日志配置

application.yml (Spring Boot)

logging:
  level:
    com.example: DEBUG
    org.springframework: WARN
  file:
    name: logs/app.log
  pattern:
    console: "%d{yyyy-MM-dd HH:mm:ss} - %logger{36} - %msg%n"
    file: "%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n"