首页标签分类
002 常见的java日志类库
2024-09-25 · 更新 2026-03-03约 2 分钟 · 282 字
java基础
000

目录

java 中常见的日志框架组成
日志门面
slf4j
common-logging
日志实现
logback
log4j2
log4j
java.util.logging
测试 slf4j + logback
测试 slf4j + log4j2

java 中常见的日志框架组成

  1. 日志门面（interfere）
  2. 日志实现 日志门面负责提供标准接口，日志实现负责具体的实现。工程建议总是使用日志门面提供的方法，不建议直接使用日志实现中的具体方法。

日志门面

slf4j

slf4j官网 使用注意事项

  1. 注意兼容 java 的版本
  2. 注意 slf4j 和各个实现兼容

common-logging

日志实现

logback

log4j2

log4j

java.util.logging

测试 slf4j + logback

  1. 引入相关依赖
plsql
自动换行：关
放大阅读
展开代码
<dependency>
    <groupId>ch.qos.logback</groupId>
    <artifactId>logback-classic</artifactId>
    <version>1.3.14</version>
</dependency>

引入 logback-classic 一次性引入了 logback-core,和 slf4j-api 两个包
2. 配置日志实现 logback 的实现默认会在项目的根目录下寻找logback.groovy，logback-test.xml，logback.xml 的配置文件，以下 提供 logback.xml 的配置，具体详细配置见注释 注意需要在配置文件指明配置生效的范围，此列中范围为 cn.hedeoer 包（节点中的 name 属性制定）

xml
自动换行：关
放大阅读
展开代码
<?xml version="1.0" encoding="UTF-8" ?>
<!-- Logback 中有效日志级别：TRACE、DEBUG、INFO、WARN、ERROR，优先级从低到高 -->
<configuration scan="true" scanPeriod="60 seconds" debug="false"> <!-- 自动重新加载配置 -->
  <property name="DIR_NAME" value="spring-helloworld"/> <!-- 日志目录的名称 -->
  <!-- 控制台输出日志 -->
  <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender"> <!-- 控制台输出 -->
    <encoder>
      <pattern>%d{HH:mm:ss.SSS} [%thread] [%-5p] %c{36}.%M - %m%n</pattern> <!-- 定义输出格式 -->
    </encoder>
  </appender>
  <!-- RollingFileAppender 开始 -->
  <appender name="ALL" class="ch.qos.logback.core.rolling.RollingFileAppender"> <!-- 所有日志文件 -->
    <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy"> <!-- 时间滚动策略 -->
      <fileNamePattern>${user.dir}/logs/${DIR_NAME}/all.%d{yyyy-MM-dd}.log</fileNamePattern> <!-- 日志文件名格式 -->
      <maxHistory>30</maxHistory> <!-- 保留30天的日志 -->
    </rollingPolicy>
    <triggeringPolicy class="ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy"> <!-- 大小触发策略 -->
      <maxFileSize>30MB</maxFileSize> <!-- 最大文件大小为30MB -->
    </triggeringPolicy>
    <encoder>
      <pattern>%d{HH:mm:ss.SSS} [%thread] [%-5p] %c{36}.%M - %m%n</pattern> <!-- 日志输出格式 -->
    </encoder>
  </appender>
  <!-- ERROR 日志专用 RollingFileAppender -->
  <appender name="ERROR" class="ch.qos.logback.core.rolling.RollingFileAppender"> <!-- 只记录错误日志 -->
    <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
      <fileNamePattern>${user.dir}/logs/${DIR_NAME}/error.%d{yyyy-MM-dd}.log</fileNamePattern>
      <maxHistory>30</maxHistory>
    </rollingPolicy>
    <triggeringPolicy class="ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy">
      <maxFileSize>10MB</maxFileSize> <!-- 最大文件大小为10MB -->
    </triggeringPolicy>
    <!-- 仅记录 ERROR 级别日志 -->
    <filter class="ch.qos.logback.classic.filter.LevelFilter">
      <level>ERROR</level> <!-- 设置日志级别为 ERROR -->
      <onMatch>ACCEPT</onMatch> <!-- 匹配时接受 -->
      <onMismatch>DENY</onMismatch> <!-- 不匹配时拒绝 -->
    </filter>
    <encoder>
      <pattern>%d{HH:mm:ss.SSS} [%thread] [%-5p] %c{36}.%M - %m%n</pattern> <!-- 输出格式 -->
    </encoder>
  </appender>
  <!-- WARN 日志专用 RollingFileAppender -->
  <appender name="WARN" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
      <fileNamePattern>${user.dir}/logs/${DIR_NAME}/warn.%d{yyyy-MM-dd}.log</fileNamePattern>
      <maxHistory>30</maxHistory>
    </rollingPolicy>
    <triggeringPolicy class="ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy">
      <maxFileSize>10MB</maxFileSize>
    </triggeringPolicy>
    <!-- 仅接受 WARN 级别日志 -->
    <filter class="ch.qos.logback.classic.filter.LevelFilter">
      <level>WARN</level> <!-- 设置日志级别为 WARN -->
            <onMatch>ACCEPT</onMatch>
            <onMismatch>DENY</onMismatch>
        </filter>
        <encoder>
            <pattern>%d{HH:mm:ss.SSS} [%thread] [%-5p] %c{36}.%M - %m%n</pattern> <!-- 日志输出格式 -->
        </encoder>
    </appender>
    <!-- INFO 日志专用 RollingFileAppender -->
    <appender name="INFO" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>${user.dir}/logs/${DIR_NAME}/info.%d{yyyy-MM-dd}.log</fileNamePattern>
            <maxHistory>30</maxHistory>
        </rollingPolicy>
        <triggeringPolicy class="ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy">
            <maxFileSize>10MB</maxFileSize>
        </triggeringPolicy>
        <!-- 仅接受 INFO 级别日志 -->
        <filter class="ch.qos.logback.classic.filter.LevelFilter">
            <level>INFO</level> <!-- 设置日志级别为 INFO -->
            <onMatch>ACCEPT</onMatch>
            <onMismatch>DENY</onMismatch>
        </filter>
        <encoder>
            <pattern>%d{HH:mm:ss.SSS} [%thread] [%-5p] %c{36}.%M - %m%n</pattern> <!-- 日志输出格式 -->
        </encoder>
    </appender>
    <!-- DEBUG 日志专用 RollingFileAppender -->
    <appender name="DEBUG" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>${user.dir}/logs/${DIR_NAME}/debug.%d{yyyy-MM-dd}.log</fileNamePattern>
            <maxHistory>30</maxHistory>
        </rollingPolicy>
        <triggeringPolicy class="ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy">
            <maxFileSize>10MB</maxFileSize>
        </triggeringPolicy>
        <!-- 仅接受 DEBUG 级别日志 -->
        <filter class="ch.qos.logback.classic.filter.LevelFilter">
            <level>DEBUG</level> <!-- 设置日志级别为 DEBUG -->
            <onMatch>ACCEPT</onMatch>
            <onMismatch>DENY</onMismatch>
        </filter>
        <encoder>
            <pattern>%d{HH:mm:ss.SSS} [%thread] [%-5p] %c{36}.%M - %m%n</pattern> <!-- 日志输出格式 -->
        </encoder>
    </appender>
    <!-- TRACE 日志专用 RollingFileAppender -->
    <appender name="TRACE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>${user.dir}/logs/${DIR_NAME}/trace.%d{yyyy-MM-dd}.log</fileNamePattern>
            <maxHistory>30</maxHistory>
        </rollingPolicy>
        <triggeringPolicy class="ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy">
            <maxFileSize>10MB</maxFileSize>
        </triggeringPolicy>
        <!-- 仅接受 TRACE 级别日志 -->
        <filter class="ch.qos.logback.classic.filter.LevelFilter">
            <level>TRACE</level> <!-- 设置日志级别为 TRACE -->
            <onMatch>ACCEPT</onMatch>
            <onMismatch>DENY</onMismatch>
        </filter>
        <encoder>
            <pattern>%d{HH:mm:ss.SSS} [%thread] [%-5p] %c{36}.%M - %m%n</pattern> <!-- 日志输出格式 -->
        </encoder>
    </appender>
    <!-- 其他日志级别（WARN、INFO、DEBUG、TRACE）配置类似，省略细节 -->
    <!-- logger 开始 -->
    <logger name="cn.hedeoer" level="info" additivity="false"> <!-- 定义特定包的日志配置 -->
        <appender-ref ref="STDOUT"/> <!-- 将日志输出到控制台 -->
        <appender-ref ref="ERROR"/>  <!-- 将错误日志输出到文件 -->
        <appender-ref ref="WARN"/>   <!-- 将警告日志输出到文件 -->
        <appender-ref ref="INFO"/>   <!-- 将信息日志输出到文件 -->
        <appender-ref ref="DEBUG"/>  <!-- 将调试日志输出到文件 -->
        <appender-ref ref="TRACE"/>  <!-- 将追踪日志输出到文件 -->
    </logger>
    <!-- 根日志配置 -->
    <root level="INFO"> <!-- 根日志级别设置为 INFO -->
        <appender-ref ref="ALL"/> <!-- 输出到所有日志 -->
    </root>
    <!-- logger 结束 -->
ECHO is off.
</configuration>
  1. 编码测试
java
自动换行：关
放大阅读
展开代码
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
public class Main {
    private static final Logger logger = LoggerFactory.getLogger(Main.class);
    public static void main(String[] args) {
        logger.info("This is an INFO message");
        logger.trace("This is a TRACE message");
        logger.debug("This is a DEBUG message");
        logger.warn("This is a WARN message");
        logger.error("This is an ERROR message");
    }
}

测试 slf4j + log4j2

同理上面的测试，需要引入相关的 log4j2 的依赖，编码中调用slf4j 的方法即可

xml
自动换行：关
放大阅读
展开代码
 <!-- https://mvnrepository.com/artifact/org.apache.logging.log4j/log4j-slf4j-impl -->
        <dependency>
            <groupId>org.apache.logging.log4j</groupId>
            <artifactId>log4j-slf4j-impl</artifactId>
            <version>2.24.0</version>
        </dependency>

本文作者:hedeoer

本文链接:

版权声明:本博客所有文章除特别声明外，均采用 BY-NC-SA 许可协议。转载请注明出处！