Spring Boot Logging Level设置为off时的Bug

为了更好的解释“Spring Boot Logging Level设置为off时的Bug”问题以及解决方案，我们需要先了解以下几个问题：

1. 什么是Logging Level
2. Spring Boot默认的Logging Level设置
3. Logging Level为off时会出现什么问题
4. 如何避免Logging Level为off导致的问题

现在我们按照这个顺序来详细讲解。

什么是Logging Level

Logging Level是指日志级别，可以用来设置日志的输出级别。Java Logging API和logback都支持多种级别的日志输出，通常来说，常用的日志级别包括：

1. TRACE：最详细的日志信息，通常用于调试阶段
2. DEBUG：指出细粒度信息事件对调试应用程序是非常有帮助的
3. INFO：输入程序运行过程中比较重要的信息，是生产环境中的默认级别
4. WARN：表明可能出现错误的情形，是一个警告
5. ERROR：指出虽然发生错误事件，但仍然不影响系统的继续运行
6. FATAL：指出每个严重的错误事件将会导致应用程序的退出

Spring Boot默认的Logging Level设置

Spring Boot默认使用的Logging框架是logback，在Spring Boot的classpath路径下可以找到一个名为“logback-spring.xml”的日志配置文件。该配置文件提供了不同Logging Level的配置。

• root的默认Logging Level是INFO
• Spring Boot的自动配置类默认的Logging Level是DEBUG

我们可以在“application.yml”或“application.properties”文件中进行Logging Level的修改

spring:
application:
name: myapp

logging:
level:
org.springframework: WARN
org.apache: WARN

上述示例中，我们将日志级别设置为WARN级别，对于Spring Framework和Apache相关的类来说，都只会记录WARN级别及以上级别的日志。

Logging Level为off时会出现什么问题

如果将Logging Level设置为OFF，就意味着应用将不会输出任何的日志信息，即使是出现了严重错误。这在开发和调试过程中是非常不利的，同时也会增大排查线上问题的难度。

另外，如果Logging Level设置为OFF，那么Logback将不会加载到日志配置文件，如果应用的日志系统依赖于日志配置文件，而将Logging Level设置为OFF，则会出现问题，应用可能会因为找不到配置文件而不能启动。

如何避免Logging Level为off导致的问题

以下是避免Logging Level为off导致的问题的方法：

• 保证至少输出ERROR级别的日志。每个应用程序都应该至少记录ERROR级别的日志，以防止应用程序出现严重问题时无法掌握细节。
• 确保不加载Logback的配置文件。当Logging Level设置为OFF时，确保不会加载日志配置文件非常重要。为此，我们可以使用CLI命令行参数-Dlogback.configurationFile和-Dlogback.disableConsoleOutput进行设置。
• 使用枚举类型来设置Logging Level。在项目中，我们可以将Logging Level的值定义为enum枚举类型，这样可以避免在代码中误用Logging Level。

下面给出两个示例:

1. 避免加载Logback的配置文件

@SpringBootApplication
public class MyAppApplication {

    public static void main(String[] args) {
        System.setProperty("logback.configurationFile", "logback.xml");
        SpringApplication app = new SpringApplication(MyAppApplication.class);

        if ("off".equals(System.getProperty("logging.level.root"))) {
            System.setProperty("logging.level.root", "ERROR");
            System.setProperty("logback.disableConsoleOutput", "true");
        }

        app.run(args);
    }

}

在这个示例中，我们检查Logging Level是否为“off”，如果是的话，就将Logging Level设置为ERROR，并禁用掉Logback的控制台输出功能。

1. 使用枚举类型来设置Logging Level

public enum LoggingLevel {

    TRACE, DEBUG, INFO, WARN, ERROR, FATAL;

    static LoggingLevel fromString(String level) {
        try {
            return LoggingLevel.valueOf(level.toUpperCase());
        } catch (Exception e) {
            return LoggingLevel.INFO;
        }
    }

    public int intValue() {
        switch (this) {
            case TRACE: return 0;
            case DEBUG: return 10;
            case INFO: return 20;
            case WARN: return 30;
            case ERROR: return 40;
            case FATAL: return 50;
            default: return Integer.MAX_VALUE;
        }
    }

    public static LoggingLevel valueOf(int level) {
        for (LoggingLevel loggingLevel : LoggingLevel.values()) {
            if (loggingLevel.intValue() == level) {
                return loggingLevel;
            }
        }

        return INFO;
    }

}

在这个示例中，我们定义了一个枚举类型“LoggingLevel”，它包含了所有的Logging Level，并提供了各种方便的方法，以便我们可以更加容易地使用Logging Level。