springboot整合日志框架log4j2

springboot整合日志框架log4j2

前言：springboot提供了默认的日志框架logback，结合slf4j门面，基于简单配置即可实现日志输出记录。但是实际开发中很多项目会使用log4j2，log4j2是log4j的升级版本，性能和安全性上比log4j更优。而相较之springboot默认的logback，结合了logback的优点，并优化了输出效率。

但是过去几年，log4j2爆过几次大雷，21年12月出现的高危漏洞一度让许多公司紧急排险，加班升级版本或者更改框架，但虽然有缺陷，但升级后依旧是市面上现存的最优日志框架。

下面说一下springboot整合log4j2的简单实现

1. 移除springboot默认框架logback

在maven中移除logback

		<dependency>
			<groupId>org.springframework.bootgroupId>
			<artifactId>spring-boot-starter-webartifactId>
			<exclusions>
				<exclusion>
					<groupId>org.springframework.bootgroupId>
					<artifactId>spring-boot-starter-loggingartifactId>
				exclusion>
			exclusions>
		dependency>

2. 引入log4j2依赖

引入log4j2依赖，同时引入lombok依赖，lombok依赖在这里主要是使用@slf4j注解，简化每次声明logger属性的代码编写

<dependency>
    <groupId>org.springframework.bootgroupId>
    <artifactId>spring-boot-starter-log4j2artifactId>
dependency>

<dependency>
    <groupId>org.projectlombokgroupId>
    <artifactId>lombokartifactId>
dependency>

3. 编写配置文件

log4j2默认从文件根路径赌气配置文件，我们可以直接在resource包下编写log4j2.xml配置文件

<configuration monitorInterval="60">
    

    
    <Properties>
        
        
        <property name="LOG_PATTERN" value="%d{yyyy-MM-dd HH:mm:ss.SSS} %highlight{%-5level}[%thread] %style{%logger{36}}{cyan} : %msg%n" />

        
        <property name="FILE_PATH" value="D://logs/" />
        <property name="FILE_NAME" value="INOTE" />
    Properties>

    <appenders>
        <console name="Console" target="SYSTEM_OUT">
            
            <PatternLayout pattern="${LOG_PATTERN}" disableAnsi="false" noConsoleNoAnsi="false"/>

            
            <ThresholdFilter level="info" onMatch="ACCEPT" onMismatch="DENY"/>

        console>

        
        <File name="FileLog" fileName="${FILE_PATH}/test.log" append="false">
            <PatternLayout pattern="${LOG_PATTERN}"/>
        File>

        
        <RollingFile name="RollingFileInfo" fileName="${FILE_PATH}/info.log" filePattern="${FILE_PATH}/${FILE_NAME}-INFO-%d{yyyy-MM-dd}_%i.log.gz">
            
            <ThresholdFilter level="info" onMatch="ACCEPT" onMismatch="DENY"/>
            <PatternLayout pattern="${LOG_PATTERN}"/>
            <Policies>
                
                <TimeBasedTriggeringPolicy interval="1"/>
                <SizeBasedTriggeringPolicy size="10MB"/>
            Policies>
            
            <DefaultRolloverStrategy max="15"/>
        RollingFile>

        
        <RollingFile name="RollingFileWarn" fileName="${FILE_PATH}/warn.log" filePattern="${FILE_PATH}/${FILE_NAME}-WARN-%d{yyyy-MM-dd}_%i.log.gz">
            
            <ThresholdFilter level="warn" onMatch="ACCEPT" onMismatch="DENY"/>
            <PatternLayout pattern="${LOG_PATTERN}"/>
            <Policies>
                
                <TimeBasedTriggeringPolicy interval="1"/>
                <SizeBasedTriggeringPolicy size="10MB"/>
            Policies>
            
            <DefaultRolloverStrategy max="15"/>
        RollingFile>

        
        <RollingFile name="RollingFileError" fileName="${FILE_PATH}/error.log" filePattern="${FILE_PATH}/${FILE_NAME}-ERROR-%d{yyyy-MM-dd}_%i.log.gz">
            
            <ThresholdFilter level="error" onMatch="ACCEPT" onMismatch="DENY"/>
            <PatternLayout pattern="${LOG_PATTERN}"/>
            <Policies>
                
                <TimeBasedTriggeringPolicy interval="1"/>
                <SizeBasedTriggeringPolicy size="10MB"/>
            Policies>
            
            <DefaultRolloverStrategy max="15"/>
        RollingFile>

    appenders>

    
    
    <loggers>

        
        <logger name="org.mybatis" level="info" additivity="false">
            <AppenderRef ref="Console"/>
        logger>
        
        
        <Logger name="org.springframework" level="info" additivity="false">
            <AppenderRef ref="Console"/>
        Logger>

        <root level="info">
            <appender-ref ref="Console"/>
            <appender-ref ref="FileLog"/>
            <appender-ref ref="RollingFileInfo"/>
            <appender-ref ref="RollingFileWarn"/>
            <appender-ref ref="RollingFileError"/>
        root>
    loggers>

configuration>

另外还可以通过application.properties文件修改配置文件位置

logging.config=classpath:log4j2.xml

4.测试

因为用的slf4j作为日志门面（相当于接口），所以实际使用上和logback是没有区别的，直接声明变量调用日志记录例子如下：

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

@RestController
@RequestMapping("/test")
public class TestController {

    Logger logger = LoggerFactory.getLogger(TestController.class);
    @GetMapping
    public Result get(){
        System.out.println("执行业务方法");
        logger.info("业务方法执行成功");
        return new Result(200,"请求成功","这是data");
    }
}

如果引入了lombok插件，可以直接使用@slf4j注解，省去声明类变量的步骤，例如

// import lombok.extern.slf4j.Slf4j;

@Slf4j
@RestController
@RequestMapping("/test")
public class TestController {

    @GetMapping
    public Result get(){
        System.out.println("执行业务方法");
        log.info("业务方法执行成功");
        return new Result(200,"请求成功","这是data");
    }
}

5. 结果

以上log4j2.xml配置例子是在 info.log/warn.log/error.log 文件满10M的时候将文件进行打包压缩，而不满10M，会追加到文件结尾，并不是按天区分日志文件（当然也可以实现按天生成日志文件，这里不赘述）

结果如下：

修改为10KB压缩打包看看例子贴图

以上全文完毕，完结散花。（另外log4j2.xml文件配置是从百度上直接找的，不是原创，注释很详细，懒得自己打）