Quarkus Native模式下GraalVM解析PGobject遇未解析类型问题求助

问题根源 #

1. 强制类注册触发依赖扫描：你的PostgresDialect被命令行强制注册到构建流程中，即便未实际使用，GraalVM Native Image的静态分析仍会遍历该类所有代码，包括unknownReader方法里的PGobject引用。
2. 字节码残留引用：即便替换Lambda为匿名类或修改方法实现，类的字节码可能仍保留PGobject的符号引用（比如泛型签名、局部变量表），导致GraalVM始终尝试解析该类型。
3. 扩展自动注册的副作用：Quarkus扩展的默认注册逻辑可能将所有方言类纳入构建，不区分依赖是否存在。

可行解决方案 #

1. 按需注册方言（推荐） #

利用Quarkus构建步骤，仅当Postgres依赖存在时才注册PostgresDialect，从根源避免无依赖时的类扫描：

import io.quarkus.deployment.annotations.BuildStep;
import io.quarkus.deployment.builditem.DependencyBuildItem;
import javax.enterprise.inject.Produces;
import java.util.Optional;

@BuildStep
void registerPostgresDialect(BuildProducer<SqlDialectBuildItem> dialectProducer,
                             @Optional DependencyBuildItem postgresDependency) {
    // 仅当Postgres依赖存在时注册方言
    if (postgresDependency != null) {
        dialectProducer.produce(new SqlDialectBuildItem(PostgresDialect.class));
    }
}

同时在扩展的pom.xml中将Postgres依赖设为optional：

<dependency>
    <groupId>org.postgresql</groupId>
    <artifactId>postgresql</artifactId>
    <scope>provided</scope>
    <optional>true</optional>
</dependency>

2. 通过GraalVM Feature控制类解析 #

自定义GraalVM Feature，仅当PGobject类存在时才允许PostgresDialect被解析：

import org.graalvm.nativeimage.hosted.Feature;
import org.graalvm.nativeimage.hosted.Feature.IsIncludedAccess;

public class PostgresDialectFeature implements Feature {
    @Override
    public boolean isIncluded(IsIncludedAccess access) {
        try {
            // 检查PGobject是否可加载
            Class.forName("org.postgresql.util.PGobject");
            return true;
        } catch (ClassNotFoundException e) {
            // 依赖不存在时跳过该类的解析
            return false;
        }
    }
}

在扩展的native-image.properties中注册该Feature：

-H:Feature=com.your.package.PostgresDialectFeature

3. 字节码转换移除无用引用 #

使用Quarkus字节码转换工具，在构建阶段动态修改PostgresDialect的unknownReader方法，当PGobject不存在时替换为无依赖实现：

import io.quarkus.deployment.annotations.BuildStep;
import io.quarkus.deployment.builditem.BytecodeTransformerBuildItem;
import org.objectweb.asm.ClassVisitor;
import org.objectweb.asm.MethodVisitor;
import org.objectweb.asm.Opcodes;

@BuildStep
void transformPostgresDialect(BuildProducer<BytecodeTransformerBuildItem> producer) {
    producer.produce(BytecodeTransformerBuildItem.simpleTransformer(
        (className, classVisitor) -> new ClassVisitor(Opcodes.ASM9, classVisitor) {
            @Override
            public MethodVisitor visitMethod(int access, String name, String desc, String signature, String[] exceptions) {
                MethodVisitor mv = super.visitMethod(access, name, desc, signature, exceptions);
                if ("unknownReader".equals(name)) {
                    try {
                        Class.forName("org.postgresql.util.PGobject");
                        return mv; // 依赖存在时保留原方法
                    } catch (ClassNotFoundException e) {
                        // 依赖不存在时返回空实现，避免引用PGobject
                        return new MethodVisitor(Opcodes.ASM9, null) {
                            @Override
                            public void visitCode() {
                                visitTypeInsn(Opcodes.NEW, "java/lang/UnsupportedOperationException");
                                visitInsn(Opcodes.DUP);
                                visitLdcInsn("Postgres dialect not available");
                                visitMethodInsn(Opcodes.INVOKESPECIAL, "java/lang/UnsupportedOperationException", "<init>", "(Ljava/lang/String;)V", false);
                                visitInsn(Opcodes.ATHROW);
                                visitInsn(Opcodes.RETURN);
                            }
                        };
                    }
                }
                return mv;
            }
        }, PostgresDialect.class.getName()
    ));
}

4. 临时绕过（不推荐） #

若以上方案无法快速落地，可在native-image.properties中添加参数强制忽略未解析类型，但可能引发运行时风险：

--allow-incomplete-classpath
-H:+AllowUnresolved

仅在确认不会实际调用PostgresDialect相关代码时使用。

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