IDEA项目搭建——使用slf4j和logback进行日志记录

最新推荐文章于 2026-04-21 09:02:15 发布

原创最新推荐文章于 2026-04-21 09:02:15 发布 · 1k 阅读

1 ·

本内容遵循CC 4.0 BY-SA版权协议

标签

#java #logback #web

本文介绍了Java里日志的门面与实现，对比了SLF4j、Log4j、Log4j2、Logback等日志组件后，选择了性能和使用性更佳的Logback。还详细说明了接入Log的步骤，包括修改pom.xml、添加配置文件等，最后提醒了日志级别和标签配置的注意事项。

一、简介

java里面日志分为两部分一个门面、一个实现，我们所熟知的SLF4j、Log4j、Log4j2、Logback的日志组件slf4j是门面提供的统一的入口，具体实现由log4j、log4j2、logback来实现

log4j由于太老作者自己也不打算重构了所以放弃

log4j2是apach的一个项目很好，但支持上面略有欠缺所以放弃

logback是之前log4j的作者自己开源的一个新的log组件，做了大量的调整及优化，性能及使用性上都有很大的提高，再加上沉淀了很多年又完全实现了slf4j，所以被我们选中使用更多了解可以去它的官网http://logback.qos.ch

二、接入Log

在这里插入图片描述
修改pom.xml文件，增加对slf4j和logback的引用，此处如果是引用了spring boot则不需要再引一下的jar包了，spring boot中已集成了这些包

<dependencies>
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-api</artifactId>
            <version>1.7.25</version>
        </dependency>
        <dependency>
            <groupId>ch.qos.logback</groupId>
            <artifactId>logback-core</artifactId>
            <version>1.2.3</version>
        </dependency>
        <dependency>
            <groupId>ch.qos.logback</groupId>
            <artifactId>logback-classic</artifactId>
            <version>1.2.3</version>
        </dependency>
 </dependencies>

直接写个main()函数作为启动入口，创建resources文件夹存放静态文件

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

public class TestLog {
    static Logger logger = LoggerFactory.getLogger(TestLog.class);
    public static void main(String[] arge){
        logger.debug("taiyonghai debug");
        logger.info("taiyonghai info");
        logger.error("taiyonghai error");
        logger.warn("taiyonghai warn");
    }
}

添加一个application.yml或application.properties配置文件均可，添加以下配置指明logback的配置xml路径

logging:
 config = classpath:logback.xml

添加logback.xml文件，用于做log的相关配置

<?xml version="1.0"?>

<!-- 属性描述 scan：性设置为true时，配置文件如果发生改变，将会被重新加载，默认值为true scanPeriod:设置监测配置文件是否有修改的时间间隔，如果没有给出时间单位，
默认单位是毫秒。当scan为true时，此属性生效。默认的时间间隔为1分钟。debug:当此属性设置为true时，将打印出logback内部日志信息，实时查看logback运行状态。默认值为false。 -->
<configuration scan="true" scanPeriod="60 seconds" debug="false">
  <!-- 定义日志文件 输入位置 -->
  <property name="logPath" value="D:/EMS/EMSServer/EMSServerLogs"/>
  <!-- 日志最大的历史 60天 -->
  <property name="maxHistory" value="60"/>

  <!-- 配置项， 通过此节点配置日志输出位置（控制台、文件、数据库）、输出格式等-->
  <!-- ConsoleAppender代表输出到控制台 -->
  <appender name="consoleLog" class="ch.qos.logback.core.ConsoleAppender">
      <!-- layout代表输出格式 -->
      <layout class="ch.qos.logback.classic.PatternLayout">
          <pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger -%msg%n</pattern>
      </layout>
  </appender>

  <!-- 日志输出文件 -->
  <appender name="fileInfoLog" class="ch.qos.logback.core.rolling.RollingFileAppender">
      <encoder>
          <pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger -%msg%n</pattern>
      </encoder>
      <!-- 滚动记录文件，先将日志记录到指定文件，当符合某个条件时，将日志记录到其他文件 RollingFileAppender-->
      <!-- 滚动策略，它根据时间来制定滚动策略.既负责滚动也负责触发滚动 -->
      <!--<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
           输出路径
          <fileNamePattern>${logPath}/info/%d.log</fileNamePattern>
          可选节点，控制保留的归档文件的最大数量，超出数量就删除旧文件假设设置每个月滚动，且<maxHistory>是6，
          则只保存最近6个月的文件，删除之前的旧文件。注意，删除旧文件是，那些为了归档而创建的目录也会被删除
          <maxHistory>${maxHistory}</maxHistory>
      </rollingPolicy>-->
      <!--若要使用FixedWindowRollingPolicy，file属性必需要有并且需要提前设置-->
      <file>${logPath}/EmsServer.log</file>
      <!-- 按照固定窗口模式生成日志文件，当文件大于50MB时，生成新的日志文件。窗口大小是1到10，当保存了10个归档文件后，将覆盖最早的日志。   -->
      <rollingPolicy class="ch.qos.logback.core.rolling.FixedWindowRollingPolicy">
          <fileNamePattern>${logPath}/EmsServers.%i.log.zip</fileNamePattern>
          <minIndex>1</minIndex>
          <maxIndex>10</maxIndex>
      </rollingPolicy>
      <!-- 查看当前活动文件的大小，如果超过指定大小会告知RollingFileAppender 触发当前活动文件滚动   -->
      <triggeringPolicy class="ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy">
          <maxFileSize>5MB</maxFileSize>
      </triggeringPolicy>
  </appender>
  <!-- 特殊记录Error日志 -->
  <appender name="fileErrorLog" class="ch.qos.logback.core.rolling.RollingFileAppender">
      <!-- 只记录ERROR级别日志，添加范围过滤，可以将该类型的日志特殊记录到某个位置 -->
      <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
          <level>ERROR</level>
      </filter>
      <encoder>
          <pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger -%msg%n</pattern>
      </encoder>
      <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
          <fileNamePattern>${logPath}/error/%d.log</fileNamePattern>
          <!-- 日志最大的历史 60天 -->
          <maxHistory>60</maxHistory>
      </rollingPolicy>
  </appender>

  <!-- 根节点，表名基本的日志级别，里面可以由多个appender规则 -->
  <!-- level="info"代表基础日志级别为info -->
  <root level="info">
      <!-- 引入控制台输出规则 -->
      <appender-ref ref="consoleLog"/>
      <appender-ref ref="fileInfoLog"/>
      <appender-ref ref="fileErrorLog"/>
  </root>

</configuration>