SpringBoot迁Quarkus构建Native Image遇ApplicationImpl未解析错误

将SpringBoot项目迁移至Quarkus，使用GraalVM CE 21.0.0.2（build 11.0.10+8-jvmci-21.0-b06，混合模式，共享）构建Native Image时，抛出如下错误：

Caused by: com.oracle.graal.pointsto.constraints.UnresolvedElementException: Discovered unresolved type during parsing: io.quarkus.runner.ApplicationImpl. To diagnose the issue you can use the --allow-incomplete-classpath option. The missing type is then reported at run time when it is accessed the first time.
        at com.oracle.svm.hosted.phases.SharedGraphBuilderPhase$SharedBytecodeParser.reportUnresolvedElement(SharedGraphBuilderPhase.java:286)
        at com.oracle.svm.hosted.phases.SharedGraphBuilderPhase$SharedBytecodeParser.handleUnresolvedType(SharedGraphBuilderPhase.java:242)
        at com.oracle.svm.hosted.phases.SharedGraphBuilderPhase$SharedBytecodeParser.handleUnresolvedNewInstance(SharedGraphBuilderPhase.java:186)
        at jdk.internal.vm.compiler/org.graalvm.compiler.java.BytecodeParser.genNewInstance(BytecodeParser.java:4619)
        at jdk.internal.vm.compiler/org.graalvm.compiler.java.BytecodeParser.genNewInstance(BytecodeParser.java:4612)
        at jdk.internal.vm.compiler/org.graalvm.compiler.java.BytecodeParser.processBytecode(BytecodeParser.java:5409)
        at jdk.internal.vm.compiler/org.graalvm.compiler.java.BytecodeParser.iterateBytecodesForBlock(BytecodeParser.java:3436)
        at jdk.internal.vm.compiler/org.graalvm.compiler.java.BytecodeParser.processBlock(BytecodeParser.java:3243)
        at jdk.internal.vm.compiler/org.graalvm.compiler.java.BytecodeParser.build(BytecodeParser.java:1109)
        at jdk.internal.vm.compiler/org.graalvm.compiler.java.BytecodeParser.buildRootMethod(BytecodeParser.java:1003)
        at jdk.internal.vm.compiler/org.graalvm.compiler.java.GraphBuilderPhase$Instance.run(GraphBuilderPhase.java:84)
        at com.oracle.svm.hosted.phases.SharedGraphBuilderPhase.run(SharedGraphBuilderPhase.java:76)
        at jdk.internal.vm.compiler/org.graalvm.compiler.phases.Phase.run(Phase.java:49)
        at jdk.internal.vm.compiler/org.graalvm.compiler.phases.BasePhase.apply(BasePhase.java:212)
        at jdk.internal.vm.compiler/org.graalvm.compiler.phases.Phase.apply(Phase.java:42)
        at jdk.internal.vm.compiler/org.graalvm.compiler.phases.Phase.apply(Phase.java:38)
        at com.oracle.graal.pointsto.flow.MethodTypeFlowBuilder.parse(MethodTypeFlowBuilder.java:223)
        at com.oracle.graal.pointsto.flow.MethodTypeFlowBuilder.apply(MethodTypeFlowBuilder.java:357)
        at com.oracle.graal.pointsto.flow.MethodTypeFlow.doParse(MethodTypeFlow.java:313)
        at com.oracle.graal.pointsto.flow.MethodTypeFlow.ensureParsed(MethodTypeFlow.java:302)
        at com.oracle.graal.pointsto.flow.MethodTypeFlow.addContext(MethodTypeFlow.java:103)
        at com.oracle.graal.pointsto.flow.StaticInvokeTypeFlow.update(InvokeTypeFlow.java:434)
        at com.oracle.graal.pointsto.BigBang$2.run(BigBang.java:547)
        at com.oracle.graal.pointsto.util.CompletionExecutor.lambda$execute$0(CompletionExecutor.java:173)
        at java.base/java.util.concurrent.ForkJoinTask$RunnableExecuteAction.exec(ForkJoinTask.java:1426)
        ... 5 more

项目依赖quarkus-resteasy，待构建服务为otf-robot-framework-interpreter。

• 使用Quarkus官方构建命令：io.quarkus.runner.ApplicationImpl是Quarkus编译阶段自动生成的类，不要直接调用native-image命令，而是用Quarkus插件提供的构建方式：

  • Maven：执行./mvnw package -Pnative
  • Gradle：执行./gradlew build -Dquarkus.package.type=native
    插件会先完成代码生成、字节码处理等前置步骤，再调用GraalVM构建Native Image。

• 清理缓存后重新构建：构建缓存可能导致生成的类未更新，先执行清理命令：

  • Maven：./mvnw clean
  • Gradle：./gradlew clean
    之后再重新执行Native构建命令。

• 检查依赖版本一致性：确保quarkus-resteasy和Quarkus核心依赖版本完全一致，建议通过引入Quarkus BOM来统一管理版本，避免版本冲突导致类生成失败。

• 移除SpringBoot遗留代码：如果项目中还保留SpringBoot的启动类、配置类等，可能干扰Quarkus的代码生成流程，彻底移除SpringBoot相关依赖和代码，改用Quarkus的原生方式配置服务。

• 升级Quarkus版本：旧版Quarkus可能和GraalVM 21.0.0.2存在兼容性问题，升级到与该GraalVM版本兼容的Quarkus版本（如Quarkus 2.16.x及以上版本）。

• 临时排查用--allow-incomplete-classpath：按照错误提示，给Native构建添加该参数，运行生成的镜像时会得到更具体的错误信息，帮助定位深层问题，但此参数不适合生产环境使用。

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