[Spring] SpringBoot 日志框架修改为 log4j2

在使用 SpringBoot 的时候，默认使用的日志框架是 logback。 现在如果想要使用 log4j2，如何做修改？

1. 排除 SpringBoot 默认的 logback 依赖

<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
<exclusions>
<exclusion>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-logging</artifactId>
</exclusion>
</exclusions>
</dependency>

1. 添加 log4j2 的依赖

<!--  使用 log4j2 替代 logback      -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-log4j2</artifactId>
</dependency>

1. 在 resources 目录下新建一个 log4j2-spring.xml 的日志配置文件

一般情况下，这样就能在 SpringBoot 里面使用 log4j2 了。 但是还能做继续做一些完善的！

• 完善1: 你项目启动的时候，可能会看到这样的日志信息

SLF4J: Class path contains multiple SLF4J bindings.
SLF4J: Found binding in [jar:file:/E:/Repertory/ch/qos/logback/logback-classic/1.2.3/logback-classic-1.2.3.jar!/org/slf4j/impl/StaticLoggerBinder.class]
SLF4J: Found binding in [jar:file:/E:/Repertory/org/apache/logging/log4j/log4j-slf4j-impl/2.12.1/log4j-slf4j-impl-2.12.1.jar!/org/slf4j/impl/StaticLoggerBinder.class]
SLF4J: See http://www.slf4j.org/codes.html#multiple_bindings for an explanation.
SLF4J: Actual binding is of type [ch.qos.logback.classic.util.ContextSelectorStaticBinder]

这个虽然不影响使用，但是强迫症，看着不舒服。 至于原因：就是项目里面使用了 slf4f 做门面，但是项目里面有复数的实现方式，解决方式也很简单：将项目里面的 其他的日志框架排除就行了。 比如使用 myBatis 导入的 starter 里面就有 logbak 的实现.

<dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>${mybatis.starter.version}</version>
<exclusions>
<exclusion>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-logging</artifactId>
</exclusion>
</exclusions>
</dependency>

项目的依赖查看，可以通过 Idea 右侧的 Maven 选项进行查看等。

• 完善2： 使用彩色日志

在使用 SpringBoot 默认的日志框架时，可以发现输出在控制台的日志是彩色的，但是现在我们换成了 log4j2，日志却是白色的，其实这里面也是支持配置的。
首先配置控制台的输出格式：

<Property name ="ConsoleLogPattern">%d{yyy-MM-dd HH:mm:ss} %style{[%15t]}{bright，blue} %clr{%-5level} %style{%logger{80}}{cyan} %style{[%L]}{magenta} - %msg%n</Property>

格式基本就是

%style{日志}{想要显示的颜色}

然后引入到控制台输出，然后设置

disableAnsi="false" noConsoleNoAnsi="false"

就能达到彩色日志的效果

<Console name="console" target="SYSTEM_OUT">
<!--输出日志的格式-->
<patternLayout pattern="${ConsoleLogPattern}" disableAnsi="false" noConsoleNoAnsi="false"/>
</Console>

• 完善3： 在 spring-log4j2.xml 使用 application.yml 配置的属性

在 SpringBoot + logback 的时候，我们可以通过在 application.yml 里面配置

logging.file.path=日志路径

来指定日志的保存地方，但是在使用 log4j2 的时候，不起作用了。 原因是： log4j2-spring.xml 是不归 spring 管理的，所以也就没法读取到 application.yml 里面的配置了。 解决方式： 通过 spring 的 监听器(Listener)功能，将我们读取到的 application.yml 的日志路径设置到系统属性，然后在日志文件里面读取对应的系统属性就行了。

首先：新建一个监听器

public class LoggingListener implements ApplicationListener，Ordered {

/**
* 提供给日志文件读取配置的key，使用时需要在前面加上 sys:
*/
private final static String LOG_PATH = "log.path";

/**
* spring 内部设置的日志文件的配置key
*/
private final static String SPRING_LOG_PATH_PROP = "logging.file.path";

@Override
public void onApplicationEvent(ApplicationEvent applicationEvent) {

if (applicationEvent instanceof ApplicationEnvironmentPreparedEvent) {
ConfigurableEnvironment environment = ((ApplicationEnvironmentPreparedEvent) applicationEvent).getEnvironment();
String filePath = environment.getProperty(SPRING_LOG_PATH_PROP);
if (filePath != null && !filePath.isBlank()) {
System.setProperty(LOG_PATH，filePath);
}
}
}

@Override
public int getOrder() {
// 当前监听器的启动顺序需要在日志配置监听器的前面，所以此处减 1
return LoggingApplicationListener.DEFAULT_ORDER - 1;
}
}

然后: 在项目启动的时候，将我们的监听器交给应用

@SpringBootApplication
public class ApplicationStarter {

public static void main(String[] args) {

SpringApplication application = new SpringApplication(ApplicationStarter.class);
// 添加 日志监听器，使 log4j2-spring.xml 可以间接读取到配置文件的属性
application.addListeners(new LoggingListener());
application.run(args);
}
}

最后: log4j2-spring.xml 里面的日志路径配置

<!--  文件保存路径 前缀 sys: 不能省   -->
<Property name="LogPath">${sys:log.path}</Property>

至此： SpringBoot 整合 log4j2 就此结束了！

参考

Use Spring boot application properties in log4j2.xml

• 点赞
• 收藏
• 分享
• 文章举报

lcn29 发布了13 篇原创文章 · 获赞 0 · 访问量 318 私信 关注