SpringBoot日志级别怎么设置？从入门到实战详解_Java

在 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）

添加依赖：

<dependency>
    <groupid>org.springframework.boot</groupid>
    <artifactid>spring-boot-starter-actuator</artifactid>
</dependency>

启用 loggers 端点：

management.endpoints.web.exposure.include=loggers

通过 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. 日志级别最佳实践

开发环境：

logging.level.root=debug

使用 debug 或 trace 级别，便于排查问题。

生产环境：

logging.level.root=info
logging.level.com.example.api=warn

默认使用 info，关键组件可设为 warn 以减少日志量。
避免 debug/trace，防止日志爆炸。

第三方库日志：

logging.level.org.springframework=warn
logging.level.hibernate=error

关闭无关日志（如 spring 内部日志）：

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	避免无关日志干扰