在 Spring Boot 中，日志级别用于控制日志输出的详细程度，从最详细的调试信息到仅关键错误信息。以下是 Spring Boot 支持的日志级别及其使用场景的详细介绍：

---

1. 日志级别概述

Spring Boot 默认使用 SLF4J 作为日志门面，并支持以下日志级别（按优先级从低到高排列）：

日志级别	描述	适用场景
TRACE	最详细的日志信息，通常用于跟踪代码执行流程	开发阶段调试复杂逻辑，如循环、递归调用跟踪
DEBUG	调试信息，比 TRACE 稍高一级	开发环境问题排查，如变量值、方法入参/出参记录
INFO	常规运行信息，表示应用正常运行的关键事件	生产环境监控，如服务启动完成、定时任务执行记录
WARN	警告信息，表示潜在问题（不影响当前操作）	非致命问题，如缓存失效、降级策略触发
ERROR	错误信息，表示需要关注的故障（但应用可能仍能运行）	异常捕获、第三方服务调用失败
FATAL	致命错误（实际很少用，通常用 ERROR 代替）	导致应用崩溃的严重错误（如 JVM OOM）
OFF	关闭所有日志	特殊场景下禁用日志

注意：

• 日志级别具有 继承性，高级别会覆盖低级别（如设置为 WARN 时，INFO 和 DEBUG 日志不会输出）。
• FATAL 在 SLF4J/Logback 中并不常用，一般用 ERROR 替代。

---

2. 日志级别配置方法

方式 1：通过 application.properties/application.yml

# 设置全局默认级别
logging.level.root=WARN

# 按包名设置特定级别
logging.level.com.example.demo=DEBUG
logging.level.org.springframework.web=INFO

或 YAML 格式：

logging:
  level:
    root: WARN
    com.example.demo: DEBUG
    org.springframework: INFO

方式 2：通过 logback-spring.xml（优先级更高）

<configuration>
    <logger name="com.example.demo" level="DEBUG" />
    <root level="INFO">
        <appender-ref ref="CONSOLE" />
    </root>
</configuration>

方式 3：动态调整（通过 Actuator）

1. 添加依赖：

   <dependency>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-actuator</artifactId>
   </dependency>
   

2. 启用 loggers 端点：

   management.endpoints.web.exposure.include=loggers
   

3. 通过 HTTP API 动态修改：

   # 查看当前级别
   GET /actuator/loggers/com.example.demo
   
   # 修改级别（POST 请求）
   POST /actuator/loggers/com.example.demo
   {
     "configuredLevel": "DEBUG"
   }
   

---

3. 日志级别继承规则

• 根记录器（Root Logger）：通过 logging.level.root 配置，是所有日志的默认级别。
• 包/类级别：
  例如 logging.level.com.example=DEBUG 会覆盖该包及其子包下所有类的日志级别。
• 优先级：
  具体类的配置 > 包配置 > 根配置。

示例：

logging.level.root=INFO          # 默认级别
logging.level.com.example=DEBUG  # 覆盖 com.example 包及其子包
logging.level.com.example.service.UserService=WARN  # 进一步覆盖具体类

---

4. 日志级别最佳实践

1. 开发环境：
   • 使用 DEBUG 或 TRACE 级别，便于排查问题。

   logging.level.root=DEBUG
   

2. 生产环境：
   • 默认使用 INFO，关键组件可设为 WARN 以减少日志量。
   • 避免 DEBUG/TRACE，防止日志爆炸。

   logging.level.root=INFO
   logging.level.com.example.api=WARN
   

3. 第三方库日志：
   • 关闭无关日志（如 Spring 内部日志）：

   logging.level.org.springframework=WARN
   logging.level.hibernate=ERROR
   

---

5. 常见问题排查

Q1：为什么 DEBUG 日志不输出？

• 检查是否在配置中设置了更高的级别（如 INFO）。
• 确认没有在 logback-spring.xml 中覆盖级别。

Q2：如何查看当前生效的日志级别？

• 通过 Actuator 端点：

  GET /actuator/loggers
  

• 或查看启动日志：

  .   ____          _            __ _ _
   /\\ / ___'_ __ _ _(_)_ __  __ _ \ \ \ \
  ( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
   \\/  ___)| |_)| | | | | || (_| |  ) ) ) )
    '  |____| .__|_| |_|_| |_\__, | / / / /
   =========|_|==============|___/=/_/_/_/
   :: Spring Boot ::  (v2.7.0)
  2023-10-01 12:00:00.000 DEBUG 1234 --- [main] com.example.MyApp : Debug message
  

Q3：如何临时启用 DEBUG 日志？

• 启动命令中添加参数：

  java -jar myapp.jar --debug  # 仅对 Spring Boot 内嵌日志生效
  

  或：

  java -jar myapp.jar --logging.level.com.example=DEBUG
  

---

总结

场景	推荐级别	理由
本地开发	DEBUG/TRACE	获取详细执行信息
生产环境默认	INFO	平衡可读性与性能
生产环境关键模块	WARN	减少噪音，聚焦潜在问题
第三方库	WARN/ERROR	避免无关日志干扰

通过合理配置日志级别，可以高效平衡调试需求与系统性能。