Quarkus集成JsonPath构建原生镜像报错的原因及解决办法咨询

问题场景与现象 #

• 基础场景：使用Docker编译Quarkus原生镜像，引入JsonPath依赖后，无额外特殊GraalVM构建参数时触发第一类构建报错，核心堆栈如下：

Call path from entry point to java.lang.ClassLoader.defineClass(String, byte[], int, int, ProtectionDomain): 
    at java.lang.ClassLoader.defineClass(ClassLoader.java:1015)
    at java.lang.ClassLoader.defineClass(ClassLoader.java:878)
    at net.minidev.asm.DynamicClassLoader.defineClass(DynamicClassLoader.java:86)
    at net.minidev.asm.BeansAccessBuilder.bulid(BeansAccessBuilder.java:313)
    at net.minidev.asm.BeansAccess.get(BeansAccess.java:111)
    at net.minidev.json.reader.BeansWriterASM.writeJSONString(BeansWriterASM.java:17)

• 调试场景：添加--report-unsupported-elements-at-runtime构建参数后，触发第二类构建报错，核心堆栈如下：

at java.base/jdk.internal.reflect.NativeConstructorAccessorImpl.newInstance0(Native Method)
    at java.base/jdk.internal.reflect.NativeConstructorAccessorImpl.newInstance(NativeConstructorAccessorImpl.java:62)
    at java.base/jdk.internal.reflect.DelegatingConstructorAccessorImpl.newInstance(DelegatingConstructorAccessorImpl.java:45)
    at java.base/java.lang.reflect.Constructor.newInstance(Constructor.java:490)
    at java.base/java.util.concurrent.ForkJoinTask.getThrowableException(ForkJoinTask.java:603)
    at java.base/java.util.concurrent.ForkJoinTask.get(ForkJoinTask.java:1006)
    at com.oracle.svm.hosted.NativeImageGenerator.run(NativeImageGenerator.java:480)
    at com.oracle.svm.hosted.NativeImageGeneratorRunner.buildImage(NativeImageGeneratorRunner.java:349)
    at com.oracle.svm.hosted.NativeImageGeneratorRunner.build(NativeImageGeneratorRunner.java:508)
    at com.oracle.svm.hosted.NativeImageGeneratorRunner.main(NativeImageGeneratorRunner.java:114)
    at com.oracle.svm.hosted.NativeImageGeneratorRunner$JDK9Plus.main(NativeImageGeneratorRunner.java:537)
Caused by: java.lang.NoClassDefFoundError: javax/security/jacc/EJBMethodPermission

• 已验证的基础事实：应用在JVM运行模式下功能完全正常，仅Docker环境下的Quarkus原生镜像构建环节出现上述异常。

异常根本原因 #

• JsonPath依赖传递引入的json-smart序列化组件，其Bean处理逻辑依赖net.minidev.asm包下的运行时动态字节码生成能力，会在程序运行期通过自定义类加载器动态生成Bean访问代理类。
• GraalVM原生镜像的核心编译逻辑是在构建阶段完成全部类加载、字节码生成、静态编译工作，默认不支持运行期动态加载新类的能力，因此会直接拦截ClassLoader.defineClass这类方法调用，触发第一类报错。
• --report-unsupported-elements-at-runtime参数仅将构建期的拦截判断逻辑调整为运行期检测，未从根本上解决动态类加载的兼容问题；该参数会触发GraalVM的全量类元数据收集逻辑，而Quarkus原生镜像的精简类加载路径默认不包含Java EE Security JACC的相关类定义，最终触发NoClassDefFoundError的二次报错。

问题性质判定 #

• 该问题不属于Quarkus框架的功能缺陷，也不是JsonPath依赖的代码逻辑错误，本质是两类技术特性的默认配置不兼容：一类是依赖运行时动态字节码生成的JSON序列化实现，一类是面向静态编译、无运行时动态能力的原生镜像编译模式，二者未做默认适配。
• 原生JsonPath及其传递依赖没有提供GraalVM原生镜像的自动适配规则，需要手动补充兼容配置才能在原生镜像环境正常运行。

可落地的解决方案 #

• 优先推荐方案：引入适配Quarkus的JsonPath扩展依赖替换原生第三方JsonPath包。该扩展内置了全部GraalVM原生镜像适配规则，包括动态类加载代理的构建期预生成、序列化逻辑兼容替换，无需手动编写适配配置，可从根源上规避上述两类报错。
• 备选方案（必须使用原生JsonPath依赖时的处理）：
  • 移除之前添加的--report-unsupported-elements-at-runtime参数，避免触发不必要的JDK类元数据收集逻辑
  • 手动补充GraalVM原生镜像兼容配置：注册net.minidev.asm相关包的反射访问元数据，将动态代理类的生成逻辑调整为构建期预生成，绕过运行时类加载限制；引入javax.security.jacc:javax.security.jacc-api依赖，解决EJBMethodPermission类找不到的问题
  • 替换json-smart的默认序列化实现，关闭运行时动态字节码生成开关，改用静态Jackson序列化逻辑处理JSON读写，完全避开动态类加载代码路径
• 注意事项：--report-unsupported-elements-at-runtime仅适合构建调试使用，不建议长期用于生产环境镜像构建，否则构建出的镜像会在运行时随机触发未处理的动态能力调用报错。

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