在使用 SpringBoot 的时候, 默认使用的日志框架是 Logback。 现在如果想要使用 Log4j2, 如何做修改？
1 使用 Log4j2
- 排除 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>
- 添加 Log4j2 的依赖
<!-- 使用 Log4j2 替代 logback -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-log4j2</artifactId>
</dependency>
- 在 resources 目录下新建一个 log4j2-spring.xml 的日志配置文件
一般情况下, 这样就能在 SpringBoot 里面使用 Log4j2 了。
但是还能做继续做一些完善的 !
2 完善 Log4j2 的使用
2.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.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>2.3 在日志配置文件使用 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 可以间接读取到配置文件的属性
// LoggingListener 也可以通过配置类等方式注入
application.addListeners(new LoggingListener());
application.run(args);
}
}最后: log4j2-spring.xml 里面的日志路径配置
<!-- 文件保存路径 前缀 sys: 不能省 -->
<Property name="LogPath">${sys:log.path}</Property>至此： SpringBoot 整合 Log4j2 就此结束了！
