如何解决Quarkus中“No suitable Log implementation”报错问题

错误原因 #

该报错由Apache Commons Logging（简称JCL）的日志实现查找逻辑在Quarkus Native静态编译环境下失效导致：
Quarkus默认使用JBoss Logging作为全局日志抽象，Native编译阶段会裁剪未被显式注册的类，JCL默认的类路径动态扫描逻辑无法在静态编译的镜像中正常工作，因此抛出找不到可用日志实现的异常。

解决方案 #

方案1（优先推荐）：引入Quarkus官方JCL适配依赖 #

直接添加Quarkus官方维护的commons-logging适配依赖，该依赖会自动处理Native编译时的类注册、日志桥接逻辑，无需额外配置：

• Maven项目在pom.xml中添加：

<dependency>
    <groupId>io.quarkus</groupId>
    <artifactId>quarkus-apache-commons-logging</artifactId>
</dependency>

• Gradle项目在build.gradle中添加：

implementation("io.quarkus:quarkus-apache-commons-logging")

添加依赖后重新执行Native编译即可正常打印日志。

方案2：手动配置桥接与Native注册 #

如果受项目依赖结构限制无法直接引入官方适配包，可以按以下步骤配置：

1. 排除所有第三方依赖传递引入的原生commons-logging包，添加JCL到JBoss Logging的桥接包：

<dependency>
    <groupId>org.jboss.logging</groupId>
    <artifactId>commons-logging-jboss-logging</artifactId>
</dependency>

2. 在application.properties中添加Native编译参数，显式指定JCL日志工厂类的初始化时机：

quarkus.native.additional-build-args=--initialize-at-run-time=org.apache.commons.logging.impl.LogFactoryImpl

方案3：替换日志API #

如果业务代码可控，直接将代码中使用org.apache.commons.logging.Log的逻辑替换为Quarkus原生支持的org.jboss.logging.Logger，从根源规避JCL的依赖问题：

import org.jboss.logging.Logger;

public class DemoService {
    private static final Logger LOG = Logger.getLogger(DemoService.class);
    
    public void doSomething() {
        LOG.info("日志输出内容");
    }
}

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