第三篇：SpringBoot日志配置

作者：唐亚峰

个人QQ：1837307557

battcn开源群（适合新手）：391619659

微信公众号（欢迎调戏）：battcn

文章来源：一起来学SpringBoot | 第三篇：SpringBoot日志配置

Spring Boot 内部采用的是 Commons Logging进行日志记录，但在底层为 Java Util Logging、Log4J2、Logback 等日志框架提供了默认配置。

Java 虽然有很多可用的日志框架，但请不要担心，一般来说，使用 SpringBoot 默认的 Logback 就可以了。

1 日志格式

SpringBoot 的默认输出的日志格式如下：

输出如下元素：

Logback 是没有 FATAL级别的日志，它将被映射到 ERROR

时间日期：精确到毫秒,可以用于排序
日志级别：ERROR、WARN、INFO、DEBUG、TRACE
进程ID
分隔符：采用 --- 来标识日志开始部分
线程名：方括号括起来（可能会截断控制台输出）
Logger名：通常使用源代码的类名
日志内容：我们输出的消息

2 日志输出

SpringBoot 默认为我们输出的日志级别为 INFO、WARN、ERROR，如需要输出更多日志的时候，可以通过以下方式开启

扫描二维码关注公众号，回复： 5668533 查看本文章

命令模式配置： java -jar app.jar --debug=true ，这种命令会被 SpringBoot 解析，且优先级最高
资源文件配置： application.properties 配置 debug=true 即可。该配置只对嵌入式容器、Spring、Hibernate生效，我们自己的项目想要输出 DEBUG 需要额外配置（配置规则：logging.level.<logger-name>=<level>）

日志输出级别配置

logging.level.root = WARN
logging.level.org.springframework.web = DEBUG
logging.level.org.hibernate = ERROR

#比如 mybatis sql日志
logging.level.org.mybatis = INFO
logging.level.mapper所在的包 = DEBUG

日志输出格式配置

logging.pattern.console： 定义输出到控制台的格式（不支持JDK Logger）
logging.pattern.file： 定义输出到文件的格式（不支持JDK Logger）

3 颜色编码

如果终端支持 ANSI，默认情况下会给日志上个色，提高可读性，可以在配置文件中设置 spring.output.ansi.enabled 来改变默认值

ALWAYS： 启用 ANSI 颜色的输出。
DETECT： 尝试检测 ANSI 着色功能是否可用。
NEVER： 禁用 ANSI 颜色的输出。

3.1 编码对照表

Level	Color
`WARN`	Yellow
`FATAL`、`ERROR`	Red
`INFO`、`DEBUG`、`TRACE`	Green

如果想修改日志默认色值，可以通过使用 %clr 关键字转换。比如想使文本变为黄色 %clr(%d{yyyy-MM-dd HH:mm:ss.SSS}){yellow}。目前支持的颜色有（blue、cyan、faint、green、magenta、red、yellow）

4 文件保存

默认情况下，SpringBoot 仅将日志输出到控制台，不会写入到日志文件中去。如果除了控制台输出之外还想写日志文件，则需要在application.properties 设置logging.file 或 logging.path 属性。

logging.file： 将日志写入到指定的文件中，默认为相对路径，可以设置成绝对路径
logging.path： 将名为 spring.log 写入到指定的 文件夹 中，如（/var/log）

日志文件在达到 10MB 时进行切割，产生一个新的日志文件（如：spring.1.log、spring.2.log），新的日志依旧输出到 spring.log 中去，默认情况下会记录 ERROR、WARN、INFO 级别消息。

logging.file.max-size： 限制日志文件大小
logging.file.max-history： 限制日志保留天数

5 自定义日志配置

由于日志在 ApplicationContext 之前就初始化好了，所以 SpringBoot 为我们提供了 logging.config 属性，方便我们配置自定义日志文件。默认情况它会根据日志的依赖自动加载。

Logging System	Customization
`JDK (Java Util Logging)`	logging.properties
`Log4j2`、`ERROR`	log4j2-spring.xml 或 log4j2.xml
`Logback`	logback-spring.xml、logback-spring.groovy、logback.xml、logback.groovy

6 Logback扩展配置

该扩展配置仅适用 logback-spring.xml 或者设置 logging.config 属性的文件，因为 logback.xml 加载过早，因此无法获取 SpringBoot的一些扩展属性

使用扩展属性 springProfile 与 springProperty 让你的 logback-spring.xml 配置显得更有逼格，当别人还在苦苦挣扎弄logback-{profile}.xml的时候你一个文件就搞定了…

6.1 springProfile

<springProfile> 标签使我们让配置文件更加灵活，它可以选择性的包含或排除部分配置。

<springProfile name="dev">
    <!-- 开发环境时激活 -->
</springProfile>

<springProfile name="dev,test">
    <!-- 开发，测试的时候激活-->
</springProfile>

<springProfile name="!prod">
    <!-- 当 "生产" 环境时，该配置不激活-->
</springProfile>

6.2 案例

<!-- 开发环境日志级别为DEBUG/并且开发环境不写日志文件 -->
<springProfile name="dev">
    <root level="DEBUG">
        <appender-ref ref="STDOUT"/>
    </root>
</springProfile>

<!-- 测试环境日志级别为INFO/并且记录日志文件 -->
<springProfile name="test">
    <root level="INFO">
        <appender-ref ref="FILE"/>
        <appender-ref ref="STDOUT"/>
    </root>
</springProfile>

6.3 springProperty

<springProperty> 标签可以让我们在 Logback 中使用 Spring Environment 中的属性。如果想在logback-spring.xml中回读 application.properties 配置的值时，这是一个非常好的解决方案

<!-- 读取 spring.application.name 属性来生成日志文件名
	scope：作用域
	name：在 logback-spring.xml 使用的键
	source：application.properties 文件中的键
	defaultValue：默认值
 -->
<springProperty scope="context" name="logName" source="spring.application.name" defaultValue="myapp.log"/>

<appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <file>logs/${logName}.log</file>
</appender>

7 个人简单示例：

示例项目结构：

7.1 application.properties文件内容如下：

# 配置日志文件路径
logging.file=D:/BaiduNetdiskDownload/spring-boot/chapter1/log/myspringboot.log
logging.level.com.battcn.chapter1.controller=debug # 不同目录下可配置不同级别
logging.level.com.battcn.chapter1.pojo=info
logging.level.com.battcn.chapter1.other=warn
logging.level.com.battcn.chapter1=info

7.2 Chapter1Application.class文件内容如下：

@RestController
@SpringBootApplication
public class Chapter1Application {
    protected static final Logger logger = LoggerFactory.getLogger(Chapter1Application.class);

    public static void main(String[] args) {
        logger.info("SpringBoot开始加载");
        SpringApplication.run(Chapter1Application.class, args);
        logger.info("SpringBoot加载完毕");
    }

    @GetMapping("/demo1")
    public String demo1(){
        return "Hello batch";
    }

    @Bean
    public CommandLineRunner commandLineRunner(ApplicationContext ctx) {
        // 目的是
        return args -> {
            System.out.println("来看看 SpringBoot 默认为我们提供的 Bean：");
            String[] beanNames = ctx.getBeanDefinitionNames();
            Arrays.sort(beanNames);
            Arrays.stream(beanNames).forEach(System.out::println);
        };
    }
}

7.3 日志记录输出文件是：myspringboot.log文件

7.4 下载

链接：https://pan.baidu.com/s/1vpQcSTet3pdYWv7LcbeTvA 提取码：y1ux

8 总结

9 文章参考：

【系统学习SpringBoot】SpringBoot配置logging日志及输出日志：https://blog.csdn.net/small_mouse0/article/details/77840582
SpringBoot2.0日志配置实例：https://blog.csdn.net/gozhuyinglong/article/details/80523756