怎么设置日志级别

Posted 2023-04-27

参考技术A 这个一个关于springmvc的坑的故事。

某天晚上本打算一个小功能分分钟搞定上线,但页面总是报404错误,肉眼实在找不到原因。 各种手段折腾,断点,重启,重新打包,拍脑袋觉得代码没写错,url路径也ok,真心没问题，无数次f5就是不出来。

很多时候遇到一个bug越着急越搞不定，我就是这种情况，花了一两个小时时间，眼看都过0点了，此时我正用最后的手段，引入spring源码直接一步步debug，看起来也没问题，那能不能更深入点，从spring启动开始。

这时我突然想到了日志，平时线上的日志级别都是error，本地一般也很少改，大多数情况都是断点debug，日志更多的是用来日后线上问题排查。所以我改了下spring的日志级别，看看他启动干了啥。

因此，修改了下log4j的配置文件，将springmvc的日志级别改为debug，如果是logback的话，配置文件也是类似。

<logger name="org.springframework.web">
<level value="DEBUG"/>
</logger>
这样的话启动后，springmvc就会打印出它所加载的路径映射，每次请求也会详细打印出请求的参数，路径等等。

然后，重启，看到控制台打印出来的路径和我实际访问的路径，问题一目了然了，原来我与显示页面只差一个字母大小写的距离。看一下时间，已然是凌晨1点，默默的在心里说一句：WTF。然后倒头就睡。

合理的日志级别

日志是我们经常用到的东西,但很多时候只有在遇到线上bug之类的情况才会想起有日志可以协助排查,但开发的时候一点点日志级别修改,就能避免某个bug调试到凌晨1点才发现与答案只差一个字母的距离。

我个人的经验，在web项目时会把三个方面的日志级别改为debug

webmvc框架：springmvc 或者struts2，主要查看请求路径和参数，页面400，404了，看看请求路径和参数对不对；
orm框架：如mybatis，debug级别会打印sql和参数，有sql异常通过日志就可以很快定位；
项目本身的业务日志，这个一般很少。
至于其他外部依赖的项目根据需要自行定义，root日志级别一般是error，不然很多其他日志混进来会导致很难查看。

对于struts2，日志级别是这么定义的。

<logger name="com.opensymphony.xwork2">
<level value="DEBUG"/>
</logger>
当然这是xml格式的配置文件，如果是properties，需要这么做

log4j.logger.com.opensymphony.xwork2=debug
mybatis的sql则可参考如下

log4j.logger.com.ibatis=debug
log4j.logger.java.sql.Connection=debug
log4j.logger.java.sql.PreparedStatement=debug

Spring Boot 日志详解

Spring Boot 日志

• 一、日志有什么用
• 二、日志怎么用
• 三、自定义日志打印
• • 3.1 在程序中得到日志对象
  • 3.2 使用日志对象打印日志
• 四、日志级别
• • 4.1 日志级别有什么用
  • 4.2 日志级别的分类与使用
  • 4.3 日志级别设置
• 五、日志持久化
• • 5.1 配置文件名
  • 5.2 配置保存路径
• 六、更简单的日志输出 -- lombok
• • 6.1 添加 lombok 依赖
  • 6.2 输出日志
  • 6.3 lombok 原理解释
  • 6.4 lombok 更多注解说明

一、日志有什么用

日志是程序的重要组成部分。想象⼀下，如果程序报错了，不让你打开控制台查看⽇志，那么你能找到报错的原因吗？
答案是否定的，写程序不是买彩票，不能完全靠猜，因此⽇志对于我们来说，最主要的⽤途就是排除和定位问题。

除了发现和定位问题之外，我们还可以通过⽇志实现以下功能：

• 记录⽤户登录⽇志，⽅便分析⽤户是正常登录还是恶意破解⽤户。
• 记录系统的操作⽇志，⽅便数据恢复和定位操作⼈。
• 记录程序的执⾏时间，⽅便为以后优化程序提供数据⽀持。

以上这些都是⽇志提供的⾮常实⽤的功能。

二、日志怎么用

Spring Boot 项⽬在启动的时候默认就有⽇志输出，如下图所示：

以上内容就是 Spring Boot 输出的控制台⽇志信息。

日志格式说明：

通过上述⽇志信息我们能得到以下 一个结论 和 三个问题：

• Spring Boot 内置了⽇志框架（不然也输出不了⽇志）。
• 默认情况下，输出的⽇志并⾮是开发者定义和打印的，那开发者怎么在程序中⾃定义打印⽇志呢？
• ⽇志默认是打印在控制台上的，⽽控制台的⽇志是不能被保存的，那么怎么把⽇志永久的保存下来呢？
• 日志打印级别默认为 INFO，那么怎样改变日志打印级别来筛选和控制日志的内容呢？

下⾯我们⼀起来寻找这些问题的答案 ~

三、自定义日志打印

开发者⾃定义打印⽇志的实现步骤：
1）得到日志对象；
2）使用日志对象提供的方法，输出自定义的日志内容。

System.out.println(); 也算是打印了日志，但是：
a. 只有打印的内容，没有其他相关信息，比如打印的时间、打印的类 (出处)…
b. 不能实现不同环境下的行为控制 (设置日志打印级别)。

3.1 在程序中得到日志对象

在程序中获取⽇志对象需要使⽤⽇志⼯⼚ LoggerFactory，如下代码所示：

    // 1.得到日志对象
    private static Logger log = LoggerFactory.getLogger(TestController.class);

日志工厂需要将每个类的类型传递进去，这样我们才知道⽇志的归属类，才能更⽅便、更直观的定位到问题类。

约定大于配置：(注意事项)

• 参数只能设置为当前类的类对象。
• Logger 对象是属于 org.slf4j 包下的，不要导入错包：
  

因为 Spring Boot 中内置了⽇志框架 slf4j，所以咱们可以直接在程序中调用 slf4j 来输出⽇志。

常⻅的⽇志框架说明（了解）

slf4j 就是一层通用的封装，类似于 JDBC ~~

3.2 使用日志对象打印日志

⽇志对象的打印⽅法有很多种：info、debug、warn… 如下代码所示：

package com.example.demo;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class TestLogging 
    // 1.得到日志对象
    private static Logger logger = LoggerFactory.getLogger(TestLogging.class);

    @RequestMapping("/hello")
    public void sayHi() 
        // 2.使用日志对象提供的方法进行日志打印
        logger.trace("Hello,i am trace.");
        logger.debug("Hello,i am debug.");
        logger.info("Hello,i am info.");
        logger.warn("Hello,i am warn");
        logger.error("Hello,i am error");
    

启动并运行，通过 http://localhost:8080/hello 访问，此时控制台打印出日志信息：

为什么 trace() 和 debug() 的打印日志没有显示呢？这与日志级别相关 ~~

四、日志级别

4.1 日志级别有什么用

• ⽇志级别可以帮你筛选出重要的信息，⽐如设置⽇志级别为 error，那么就可以只看程序的报错⽇志了，对于普通的调试⽇志和业务⽇志就可以忽略了，从⽽节省开发者信息筛选的时间。
• ⽇志级别可以控制不同环境下，⼀个程序是否需要打印⽇志，如开发环境我们需要很详细的信息，而生产环境为了保证性能和安全性就会输入尽量少的日志，而通过日志的级别就可以实现此需求。

4.2 日志级别的分类与使用

⽇志的级别分为：

• trace：踪迹的意思，级别最低；
• debug：需要调试时候的关键信息打印；
• info：普通的打印信息（默认⽇志级别）；
• warn：警告，不影响使用，但需要注意的问题；
• error：错误信息，级别较⾼的错误⽇志信息；
• fatal：致命的，因为代码异常导致程序退出执行的事件。

⽇志级别的顺序：

级别越高接收到的消息就越少，如设置了 warn 就只能收到 warn、error、fatal 级别的日志了。

总共有 6 种级别，打印的时候为什么只有 5 种，而没有 fatal 呢？
因为 fatal 是 “致命” 的，只会在代码异常导致程序退出的时候才记录，自己没法自定义 ~~

4.3 日志级别设置

日志的输出级别默认是 info。

在上面我们自定义了五个等级的打印日志，却只看到了三个：

这是因为此时是默认日志级别 info，怎样进行日志级别设置呢？

日志级别配置只需要在配置⽂件中设置 “logging.level” 配置项即可，如下所示：

logging:
  level:
    root: trace

这是配置跟路径的日志级别。
而日志级别的设置可以是非常精细的 (根据包)：

logging:
  level:
    root: warn
    com:
      example:
        demo: debug

重新启动运行，此时再通过 http://localhost:8080/hello 访问：

这样就可以自定义设置日志级别了 ~~

五、日志持久化

以上的⽇志都是输出在控制台上的，然⽽在⽣产环境上咱们需要将⽇志保存下来，以便出现问题之后追溯问题，把⽇志保存下来的过程就叫做持久化。

想要将⽇志进⾏持久化，只需要在配置⽂件中指定⽇志的存储⽬录或者是指定⽇志保存⽂件名，Spring Boot 就会将控制台的⽇志写到相应的⽬录或⽂件下了。

5.1 配置文件名

# 设置⽇志⽂件的⽂件名
logging:
  file:
    name: C:\\yyhjava_project\\tmp\\yyh.log

只指定文件名的话，就是生成在项目的根路径 ~~

配置完成后，启动并运行，此时在 C:\\yyhjava_project\\tmp\\ 路径下：

就生成了 yyh.log 日志文件。打开它：

此时通过 http://localhost:8080/hello 访问：

得到结论：日志是追加的，不会覆盖 ~~
重新运行依然是追加：

一直追加，文件不是会特别大吗？
并不是。当日志比较大的时候，会自动分隔成多个文件。

5.2 配置保存路径

# 设置⽇志⽂件的⽬录
logging:
  file:
    path: C:\\yyhjava_project\\tmp\\

配置完成后，启动并运行，此时在 C:\\yyhjava_project\\tmp\\ 路径下：

生成了 spring.log 日志文件 (默认文件名就是 spring.log)。

各种性质与文件名方式生成的一致 ~~

六、更简单的日志输出 – lombok

每次都使用 LoggerFactory.getLogger(xxx.class) 很繁琐，且每个类都添加一遍也很麻烦，这⾥讲一种更好⽤的⽇志输出⽅式，使⽤ lombok 来更简单的输出。
1）添加 lombok 框架支持
2）使用 @slf4j 注解输出日志

6.1 添加 lombok 依赖

或者右击鼠标添加依赖：

或者使用插件：

6.2 输出日志

package com.example.demo;

import lombok.extern.slf4j.Slf4j;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@Slf4j
@RequestMapping("/p")
public class TestLogging 
    @RequestMapping("/log")
    public void loggerTest() 
        log.error("------------------- error -----------------");
    

通过 http://localhost:8080/p/log 访问后，查看控制台：

也成功打印出了日志。

注意： 使用 @Slf4j 注解，在程序中使⽤ log 对象即可输入日志，并且只能使⽤ log 对象才能输出，这是 lombok 提供的对象名。

6.3 lombok 原理解释

lombok 能够打印日志的秘密就在 target ⽬录⾥⾯，target 为项目最终执行的代码，查看 target 目录如下：

Java 程序的运行原理：

Lombok 的作用如下图所示：

6.4 lombok 更多注解说明

基本注解

注解	作用
@Getter	⾃动添加 getter ⽅法
@Setter	⾃动添加 setter ⽅法
@ToString	⾃动添加 toString ⽅法
@EqualsAndHashCode	⾃动添加 equals 和 hashCode ⽅法
@NoArgsConstructor	⾃动添加⽆参构造⽅法
@AllArgsConstructor	⾃动添加全属性构造⽅法，顺序按照属性的定义顺序
@NonNull	属性不能为 null
@RequiredArgsConstructor	⾃动添加必需属性的构造⽅法，final + @NonNull 的属性为必需

组合注解

注解	作用
@Data	@Getter + @Setter + @ToString + @EqualsAndHashCode + @RequiredArgsConstructor + @NoArgsConstructor

日志注解

注解	作用
@Slf4j	添加⼀个名为 log 的⽇志，使⽤ slf4j