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启动时如何通过启动参数指定logback的位置

    SpringBoot启动时如何通过启动参数指定logback的位置

    这篇文章主要介绍了SpringBoot启动时如何通过启动参数指定logback的位置,在spring boot中,使用logback配置的方式常用的有两种,本文给大家介绍的非常详细,需要的朋友可以参考下
    2023-07-07
  • SpringBoot项目从开发到打包发布的完整教程

    SpringBoot项目从开发到打包发布的完整教程

    本文手把手带你从零搭建 SpringBoot 项目,实现Redis 缓存 + MySQL 日志 + 第三方接口调用,并完成服务器打包部署,全程与 Node.js 对比,新手也能快速上手,需要的朋友可以参考下
    2026-04-04
  • Java 使用 HttpClient 发送 GET请求和 POST请求

    Java 使用 HttpClient 发送 GET请求和 POST请求

    本文主要介绍了Java 使用 HttpClient 发送 GET请求和 POST请求,文中通过示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2021-08-08
  • 类似Object监视器方法的Condition接口(详解)

    类似Object监视器方法的Condition接口(详解)

    下面小编就为大家带来一篇类似Object监视器方法的Condition接口(详解)。小编觉得挺不错的,现在就分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-05-05
  • Java8新特性Optional常用方法

    Java8新特性Optional常用方法

    optional类是Java8新增加的一个对象容器,主要的功能有对象的创建、获取、判断、过滤,映射等,下面这篇文章主要给大家介绍了关于Java8新特性Optional常用方法的相关资料,需要的朋友可以参考下
    2024-02-02
  • Java连接Mysql数据库详细代码实例

    Java连接Mysql数据库详细代码实例

    这篇文章主要介绍了Java连接Mysql数据库详细代码实例,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-02-02
  • Java为何需要平衡方法调用与内联

    Java为何需要平衡方法调用与内联

    这篇文章主要介绍了Java为何需要平衡方法调用与内联,帮助大家更好的理解和使用Java,感兴趣的朋友可以了解下
    2021-01-01
  • 深度解析Spring Boot dataSource与Starter

    深度解析Spring Boot dataSource与Starter

    在Spring Boot开发中,数据源和Starter是极易混淆的核心概念,本文通过「改造前 vs 改造后」的对比,帮你直观理解两者的本质与价值,彻底解决“该导哪个依赖、该怎么配”的困惑,感兴趣的朋友跟随小编一起看看吧
    2026-03-03
  • maven+springboot打成jar包的方法

    maven+springboot打成jar包的方法

    这篇文章主要介绍了maven+springboot打成jar包的方法,非常不错,具有一定的参考借鉴价值,需要的朋友可以参考下
    2018-10-10
  • spring定时任务执行两次及tomcat部署缓慢问题的解决方法

    spring定时任务执行两次及tomcat部署缓慢问题的解决方法

    这篇文章主要给大家介绍了关于spring定时任务执行两次及tomcat部署缓慢问题的解决方法,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面小编来一起学习学习吧。
    2018-01-01

最新评论