Quarkus项目转Native Image遇Amazon SQS扩展库日志依赖问题求助

核心原因 #

commons-logging的LogFactoryImpl.handleThrowable方法在Native Image构建阶段未被正确解析，因为该类被标记为构建时链接，但对应方法未被纳入镜像构建范围。

可行解决方案 #

1. 替换commons-logging为SLF4J桥接 #

Quarkus默认采用SLF4J作为日志门面，通过排除依赖+引入桥接包的方式替换commons-logging，从根源避免原生镜像冲突：
在pom.xml（Maven）或build.gradle（Gradle）中操作：

Maven示例：

<dependency>
    <groupId>software.amazon.awssdk</groupId>
    <artifactId>sqs-extended-client</artifactId>
    <exclusions>
        <exclusion>
            <groupId>commons-logging</groupId>
            <artifactId>commons-logging</artifactId>
        </exclusion>
    </exclusions>
</dependency>
<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>jcl-over-slf4j</artifactId>
</dependency>

Gradle示例：

implementation('software.amazon.awssdk:sqs-extended-client') {
    exclude group: 'commons-logging', module: 'commons-logging'
}
implementation 'org.slf4j:jcl-over-slf4j'

2. 配置Native Image强制包含缺失方法 #

若替换桥接不可行，直接告知GraalVM在构建时包含目标方法：
在项目src/main/resources/META-INF/native-image/目录下创建reflect-config.json，添加内容：

[
    {
        "name": "org.apache.commons.logging.impl.LogFactoryImpl",
        "methods": [
            {
                "name": "handleThrowable",
                "parameterTypes": ["java.lang.Throwable"]
            }
        ]
    }
]

也可在application.properties中添加Quarkus原生镜像配置：

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

注：若仍有问题，可临时添加--allow-incomplete-classpath作为兜底，但该参数可能掩盖其他潜在问题，需谨慎使用。

3. 切换为Quarkus官方AWS SQS扩展 #

Quarkus官方提供的AWS SQS扩展已做原生镜像优化，完全适配Native Image构建，可彻底规避第三方库依赖问题：
添加依赖到项目：

Maven：

<dependency>
    <groupId>io.quarkus</groupId>
    <artifactId>quarkus-amazon-sqs</artifactId>
</dependency>

Gradle：

implementation 'io.quarkus:quarkus-amazon-sqs'

随后替换原有SQS扩展客户端的使用逻辑为Quarkus提供的客户端即可。

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