Quarkus 3.3.0移除LogController的原因及替代方案咨询

1. LogController在Quarkus 3.3.0中被移除的原因 #

io.quarkus.vertx.http.runtime.logstream.LogController属于Quarkus内部非公开API，并非官方对外承诺兼容性的组件。Quarkus 3.3.0版本对Vert.x HTTP日志模块做了架构精简，目的是减少内部依赖耦合、统一日志管理的入口设计，因此移除了这个仅用于内部实现的类。官方始终不建议依赖这类非公开API，因为它们在版本迭代中随时可能被调整或移除。

2. 运行时修改日志级别的替代方案 #

Quarkus 3.x提供了多种官方支持的运行时修改日志级别的方式：

• 使用内置日志管理REST端点：
  在application.properties中开启端点：

  quarkus.log.rest.enabled=true
  

  之后通过POST请求修改指定日志类别级别，示例：

  curl -X POST -H "Content-Type: application/json" -d '{"level": "DEBUG"}' http://localhost:8080/q/logging/com.example.MyService
  

• 直接调用JBoss Logging API：
  通过org.jboss.logging.Logger实例动态调整级别，示例代码：

  import org.jboss.logging.Logger;
  
  public class LogLevelUpdater {
      public void updateLogLevel(String category, String targetLevel) {
          Logger targetLogger = Logger.getLogger(category);
          targetLogger.setLevel(Logger.Level.valueOf(targetLevel.toUpperCase()));
      }
  }
  

• 结合MicroProfile配置刷新：
  通过配置中心修改quarkus.log.category.${category}.level属性，再调用/q/config/refresh端点触发配置刷新，适合需要持久化配置的场景。

3. LogContext修改日志级别无需设置根日志级别的解决方法 #

默认情况下，LogContext配置的日志类别会继承根日志级别限制，要绕过这个限制可以按以下方式操作：

• 设置日志类别独立级别（关闭继承）：
  通过LogContext配置时，指定不继承父级（包括根）的级别，示例代码：

  import org.jboss.logging.LogContext;
  import org.jboss.logging.Logger;
  
  public void setDebugLevelIndependently() {
      LogContext logContext = LogContext.getLogContext();
      LogContext.Configuration config = logContext.getConfiguration();
      // 第三个参数false表示该类别不继承父级级别
      config.setLevel("com.example.MyService", Logger.Level.DEBUG, false);
      logContext.updateConfiguration(config);
  }
  

• 检查日志处理器阈值：
  确保日志处理器（如控制台处理器）的级别阈值不高于目标级别，否则即使日志器设为DEBUG，处理器也会过滤日志。可在配置中调整：

  # 全局控制台处理器级别设为DEBUG
  quarkus.log.handler.console.level=DEBUG
  # 或仅针对目标类别设置处理器级别
  quarkus.log.handler.console.category.com.example.MyService.level=DEBUG
  

内容的提问来源于stack exchange，提问作者RITHEESH DEVARAJ