Spring Boot 使用 SLF4J 实现控制台输出与分类日志文件管理

概述

在日常的 Java 项目开发中,日志是最重要的调试与排查手段之一。为了便于开发时实时查看,同时在生产中追踪问题,我们通常希望实现以下日志管理目标:

  • ✅ 控制台实时输出日志,方便开发调试
  • ✅ 日志根据级别分类保存,例如:info.logwarn.logerror.log
  • ✅ 日志文件按日期滚动保存,防止文件过大
  • ✅ 日志保存在 logs/ 文件夹中,项目内统一管理

在本文中,我们将使用 Spring Boot + SLF4J + Logback 组合,完成这一目标。

为什么选择 SLF4J + Logback?

SLF4J 是一个日志"门面",可以灵活对接多种日志实现,如 Logback、Log4j、Log4j2。

Logback 是 Spring Boot 默认日志实现,功能强大、性能优越。

实战

假设现在有一个项目,项目的结构如下:

配置 application.yaml

yaml 复制代码
# 日志配置
logging:
  # 读取日志配置文件,即 resources 文件夹下的配置文件
  config: classpath:log4j2.xml
  level:
    # 默认整个项目的日志级别
    root: info
    # 如果你想细化项目日志级别,com.cbf下的日志级别是info
    # com.cbf: info

添加日志配置文件

xml 复制代码
<?xml version="1.0" encoding="UTF-8"?>
<configuration>

  <!-- 日志存放路径(当前项目的 logs 文件夹) -->
  <property name="log.path" value="./logs"/>

  <!-- 日志输出格式 -->
  <property name="log.pattern" value="%d{HH:mm:ss.SSS} [%thread] %-5level %logger{20} - [%method,%line] - %msg%n"/>

  <!-- 控制台输出 -->
  <appender name="console" class="ch.qos.logback.core.ConsoleAppender">
    <encoder>
      <pattern>${log.pattern}</pattern>
    </encoder>
  </appender>

  <!-- INFO 级别日志输出 -->
  <appender name="file_info" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <file>${log.path}/sys-info.log</file>
    <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
      <!-- 按天滚动 -->
      <fileNamePattern>${log.path}/sys-info.%d{yyyy-MM-dd}.log</fileNamePattern>
      <!-- 保留60天历史 -->
      <maxHistory>60</maxHistory>
    </rollingPolicy>
    <encoder>
      <pattern>${log.pattern}</pattern>
    </encoder>
    <filter class="ch.qos.logback.classic.filter.LevelFilter">
      <level>INFO</level>
      <onMatch>ACCEPT</onMatch>
      <onMismatch>DENY</onMismatch>
    </filter>
  </appender>

  <!-- ERROR 级别日志输出 -->
  <appender name="file_error" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <file>${log.path}/sys-error.log</file>
    <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
      <fileNamePattern>${log.path}/sys-error.%d{yyyy-MM-dd}.log</fileNamePattern>
      <maxHistory>60</maxHistory>
    </rollingPolicy>
    <encoder>
      <pattern>${log.pattern}</pattern>
    </encoder>
    <filter class="ch.qos.logback.classic.filter.LevelFilter">
      <level>ERROR</level>
      <onMatch>ACCEPT</onMatch>
      <onMismatch>DENY</onMismatch>
    </filter>
  </appender>

  <!-- 根日志记录器:所有未指定 logger 的日志都会走这里 -->
  <root level="info">
    <!-- 输出到控制台。 -->
    <appender-ref ref="console"/>
    <!-- 输出到 sys-info.log 文件(只记录 INFO 级别)。-->
    <appender-ref ref="file_info"/>
    <!-- 输出到 sys-error.log 文件(只记录 ERROR 级别)。 -->
    <appender-ref ref="file_error"/>
  </root>
</configuration>

效果检验

项目启动后,

  • 控制台将输出全部日志内容。
  • 项目根目录会生成 logs/ 文件夹。
  • 根据不同级别,日志被写入:
  • sys-info.log:包含 INFO 及以上所有级别
  • sys-error.log:只包含 ERROR 级别日志
  • 日志每天自动生成新文件,如:all.2025-06-05.log

输出效果如下:

相关推荐
武子康1 小时前
Java-80 深入浅出 RPC Dubbo 动态服务降级:从雪崩防护到配置中心秒级生效
java·分布式·后端·spring·微服务·rpc·dubbo
舒一笑1 小时前
我的开源项目-PandaCoder迎来史诗级大更新啦
后端·程序员·intellij idea
@昵称不存在3 小时前
Flask input 和datalist结合
后端·python·flask
zhuyasen3 小时前
Go 分布式任务和定时任务太难?sasynq 让异步任务从未如此简单
后端·go
东林牧之3 小时前
Django+celery异步:拿来即用,可移植性高
后端·python·django
超浪的晨4 小时前
Java UDP 通信详解:从基础到实战,彻底掌握无连接网络编程
java·开发语言·后端·学习·个人开发
AntBlack4 小时前
从小不学好 ,影刀 + ddddocr 实现图片验证码认证自动化
后端·python·计算机视觉
Pomelo_刘金5 小时前
Clean Architecture 整洁架构:借一只闹钟讲明白「整洁架构」的来龙去脉
后端·架构·rust
双力臂4045 小时前
Spring Boot 单元测试进阶:JUnit5 + Mock测试与切片测试实战及覆盖率报告生成
java·spring boot·后端·单元测试
itLaity6 小时前
基于Kafka实现简单的延时队列
spring boot·分布式·kafka