不灭的焱

在 Spring Boot 中动态修改 Logback 日志级别（无需重启应用），可通过 Spring Boot Actuator 端点 或 编程式 API 实现，核心是利用 Logback 自身的日志级别管理能力。以下是两种常用方案：

一、方案 1：通过 Spring Boot Actuator（推荐，无代码侵入）

Spring Boot Actuator 提供了 loggers 端点，可直接查询和修改日志级别，适合生产环境快速调整。

步骤 1：添加 Actuator 依赖

在 pom.xml 中添加依赖（确保已引入 Logback，Spring Boot 默认集成）：

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

步骤 2：配置 Actuator 暴露 loggers 端点

在 application.yml 中开启 loggers 端点（默认仅暴露 health、info）：

management:
  endpoints:
    web:
      exposure:
        include: loggers  # 暴露 loggers 端点（可添加其他端点，如 health, info）
  endpoint:
    loggers:
      enabled: true  # 启用 loggers 端点（默认已启用）

步骤 3：动态修改日志级别

通过 HTTP 请求调用 loggers 端点修改级别，支持 全局级别 或 指定包 / 类级别。

（1）查询当前日志级别

• 查看全局日志级别：

  curl http://localhost:8080/actuator/loggers/ROOT
  

  响应示例（level 为当前级别）：

  {
    "configuredLevel": "INFO",
    "effectiveLevel": "INFO"
  }
  

• 查看指定包 / 类的日志级别（如 com.example.controller）：

  curl http://localhost:8080/actuator/loggers/com.example.controller
  

（2）修改日志级别

发送 POST 请求，通过 JSON 体指定目标级别（支持 TRACE、DEBUG、INFO、WARN、ERROR、OFF）。

• 修改全局级别（ROOT Logger）：

  curl -X POST http://localhost:8080/actuator/loggers/ROOT \
  -H "Content-Type: application/json" \
  -d '{"configuredLevel": "DEBUG"}'

• 修改指定包级别（如 com.example.service）：

  curl -X POST http://localhost:8080/actuator/loggers/com.example.service \
  -H "Content-Type: application/json" \
  -d '{"configuredLevel": "DEBUG"}'

• 修改指定类级别（如 com.example.controller.UserController）：

  curl -X POST http://localhost:8080/actuator/loggers/com.example.controller.UserController \
  -H "Content-Type: application/json" \
  -d '{"configuredLevel": "TRACE"}'

• 重置级别（恢复为继承的上级级别）：

  curl -X POST http://localhost:8080/actuator/loggers/com.example.service \
  -H "Content-Type: application/json" \
  -d '{"configuredLevel": null}'

二、方案 2：编程式 API（自定义逻辑）

通过 Logback 提供的 LoggerContext 和 Logger 类，在代码中动态修改级别，适合需要根据业务逻辑自动调整的场景。

步骤 1：注入 Logback 上下文

Logback 的日志级别管理核心是 ch.qos.logback.classic.LoggerContext 和 ch.qos.logback.classic.Logger，可通过 Spring 注入或直接获取：

import ch.qos.logback.classic.Level;
import ch.qos.logback.classic.Logger;
import ch.qos.logback.classic.LoggerContext;
import org.slf4j.LoggerFactory;
import org.springframework.stereotype.Component;
 
@Component
public class LogLevelManager {
 
    // 获取 Logback 上下文（LoggerFactory 实际返回 Logback 的 LoggerContext）
    private final LoggerContext loggerContext = (LoggerContext) LoggerFactory.getILoggerFactory();
 
    // 修改指定包/类的日志级别
    public void setLogLevel(String loggerName, String level) {
        // 获取目标 Logger（loggerName 为包名或类名，ROOT 对应全局）
        Logger logger = loggerContext.getLogger(loggerName);
        if (logger == null) {
            throw new IllegalArgumentException("Logger 不存在：" + loggerName);
        }
        // 转换级别（支持 TRACE/DEBUG/INFO/WARN/ERROR/OFF）
        Level logLevel = Level.toLevel(level.toUpperCase(), Level.INFO); // 默认为 INFO
        logger.setLevel(logLevel);
    }
 
    // 获取当前级别
    public String getLogLevel(String loggerName) {
        Logger logger = loggerContext.getLogger(loggerName);
        Level level = logger.getEffectiveLevel(); // 获取有效级别（考虑继承关系）
        return level != null ? level.toString() : "UNDEFINED";
    }
}

步骤 2：在业务中调用

通过 Controller 或 Service 调用上述工具类，实现动态调整：

import org.springframework.web.bind.annotation.*;
 
@RestController
@RequestMapping("/log")
public class LogController {
 
    private final LogLevelManager logLevelManager;
 
    public LogController(LogLevelManager logLevelManager) {
        this.logLevelManager = logLevelManager;
    }
 
    // 修改日志级别
    @PostMapping("/level")
    public String setLogLevel(
            @RequestParam String loggerName,  // 包名/类名，如 "com.example.service" 或 "ROOT"
            @RequestParam String level) {     // 级别：DEBUG/INFO/WARN 等
        logLevelManager.setLogLevel(loggerName, level);
        return "日志级别已修改：" + loggerName + " → " + level;
    }
 
    // 查询日志级别
    @GetMapping("/level")
    public String getLogLevel(@RequestParam String loggerName) {
        String level = logLevelManager.getLogLevel(loggerName);
        return loggerName + " 当前日志级别：" + level;
    }
}

测试

• 调用修改接口：POST http://localhost:8080/log/level?loggerName=com.example.service&level=DEBUG
• 调用查询接口：GET http://localhost:8080/log/level?loggerName=com.example.service

三、关键说明

1. 级别继承关系：若未指定某个包 / 类的级别，它会继承上级包的级别（最终继承 ROOT 级别）。例如：com.example.controller 未指定级别时，会继承 com.example 的级别，若 com.example 也未指定，则继承 ROOT 级别。
2. 生效范围：动态修改的级别仅在当前应用生命周期内有效，重启应用后会恢复为 logback-spring.xml 中的配置。若需持久化，需结合配置中心（如 Nacos、Apollo）存储级别，并在应用启动时加载。
3. 与 logback-spring.xml 的关系：配置文件中的级别是初始值，动态修改会覆盖初始值，但不会修改配置文件本身。

四、扩展：结合配置中心持久化

若需重启后保留修改的级别，可将日志级别存储在配置中心（如 Nacos），并通过 Spring Cloud 动态刷新：

1. 在 Nacos 中添加配置：logging.level.com.example.service=DEBUG；
2. 应用中引入 spring-cloud-starter-alibaba-nacos-config 依赖，开启动态刷新；
3. 配置中心修改后，应用自动更新日志级别（无需调用 Actuator 或 API）。

总结

• 快速临时调整：优先用 Actuator 的 loggers 端点，简单高效，适合运维操作；
• 业务联动调整：用编程式 API，结合业务逻辑动态修改（如根据系统负载调整日志详细程度）；
• 持久化需求：结合配置中心，确保重启后级别不丢失。