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

 更新时间:2025年11月19日 10:39:30   作者:奋力向前123  
本文介绍了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">
        <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="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{36} - %msg%n"/>
        </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"
  • 选择合适的日志级别:生产环境用INFO,开发环境用DEBUG
  • 使用占位符:避免不必要的字符串拼接
  • 合理记录异常:总是传递异常对象给logger
  • 性能考虑:在循环或高性能代码中使用条件判断
  • 使用MDC:便于日志追踪和排查问题
  • 异步日志:在高并发场景下使用异步日志提升性能
  • 日志轮转:配置合理的日志文件大小和保存时间

到此这篇关于JAVA Log 日志级别和使用技巧的文章就介绍到这了,更多相关java log日志级别内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • SpringBoot项目使用mybatis-plus代码生成的实例详解

    SpringBoot项目使用mybatis-plus代码生成的实例详解

    mybatis-plus是mybatis的增强,不对mybatis做任何改变,涵盖了代码生成,自定义ID生成器,快速实现CRUD,自动分页,逻辑删除等功能。本文就来讲讲SpringBoot项目如何使用mybatis-plus实现代码生成,需要的可以了解一下
    2022-10-10
  • SpringBoot接收参数使用的注解实例讲解

    SpringBoot接收参数使用的注解实例讲解

    这篇文章主要介绍了详解SpringBoot接收参数使用的几种常用注解,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2022-08-08
  • java协变返回类型使用示例

    java协变返回类型使用示例

    在面向对象程序设计中,协变返回类型指的是子类中的成员函数的返回值类型不必严格等同于父类中被重写的成员函数的返回值类型,而可以是更"狭窄"的类型
    2014-02-02
  • MyBatis中一对多的xml配置方式(嵌套查询/嵌套结果)

    MyBatis中一对多的xml配置方式(嵌套查询/嵌套结果)

    这篇文章主要介绍了MyBatis中一对多的xml配置方式(嵌套查询/嵌套结果),具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-03-03
  • Java实现二分法变种的示例代码

    Java实现二分法变种的示例代码

    这篇文章主要为大家介绍了Java实现二分法变种的示例代码复,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-11-11
  • 详解Spring MVC自动为对象注入枚举类型

    详解Spring MVC自动为对象注入枚举类型

    本篇文章主要介绍了Spring MVC自动为对象注入枚举类型,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-04-04
  • JAVA文件读取常用工具类(8种)

    JAVA文件读取常用工具类(8种)

    JAVA操作文件在经常会使用到,本文汇总了部分JAVA操作文件的读取常用工具类,主要介绍了8种方法,具有一定的参考价值,感兴趣的可以了解一下
    2021-08-08
  • org.apache.zookeeper.KeeperException.BadVersionException异常的解决

    org.apache.zookeeper.KeeperException.BadVersionException异常的解

    在使用Apache ZooKeeper进行分布式协调时,你可能会遇到org.apache.zookeeper.KeeperException.BadVersionException异常,本文就来介绍一下解决方法,感兴趣的可以了解一下
    2024-03-03
  • 详解JAVA中转义字符

    详解JAVA中转义字符

    本篇文章主要介绍了详解JAVA中转义字符,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-08-08
  • MyBatis-Plus通过插件将数据库表生成Entiry,Mapper.xml,Mapper.class的方式

    MyBatis-Plus通过插件将数据库表生成Entiry,Mapper.xml,Mapper.class的方式

    今天小编就为大家分享一篇关于MyBatis-Plus通过插件将数据库表生成Entiry,Mapper.xml,Mapper.class的方式,小编觉得内容挺不错的,现在分享给大家,具有很好的参考价值,需要的朋友一起跟随小编来看看吧
    2019-02-02

最新评论