GraalVM Native Image反射功能失效无法获取类构造函数问题咨询

问题产生原因 #

GraalVM Native Image 构建时默认遵循封闭世界假设，只会将代码中显式直接调用的类、方法、构造函数等元素纳入最终镜像，所有通过反射访问的元素如果没有提前完成反射注册，会在构建阶段被裁剪掉，不会包含到最终的可执行文件中。

你的测试类Main的默认无参构造函数没有被任何代码直接调用，也没有注册到GraalVM的反射元数据配置中，因此构建原生镜像时被直接裁剪，运行时通过getConstructors()自然获取不到任何构造函数，输出结果为0。

该问题影响Jackson反序列化的原因也一致：Jackson反序列化的底层逻辑是通过反射调用目标类的无参构造函数生成实例，目标类的构造函数没有完成反射注册的情况下，就会抛出找不到对应构造函数的错误。

解决方案 #

你可以通过以下三种常用方式解决反射裁剪的问题：

• 方式一：使用GraalVM官方提供的@RegisterForReflection注解标注需要反射访问的类，注解会自动将该类的所有构造函数、方法、字段注册到反射配置中，无需手动编写配置文件，代码示例如下：

package it.r;

import org.graalvm.nativeimage.hosted.RegisterForReflection;

@RegisterForReflection
public class Main {

    public static void main(String[] args) {
        System.out.println("********");
        System.out.println(Main.class.getConstructors().length);
        System.out.println("********");
    }
}

• 方式二：手动编写反射配置文件reflect-config.json，放置到项目的src/main/resources/META-INF/native-image/约定目录下，native-maven-plugin构建时会自动识别加载，配置示例如下：

[
  {
    "name": "it.r.Main",
    "allPublicConstructors": true
  }
]

• 方式三：使用GraalVM Tracing Agent，先以普通Java模式运行你的应用，覆盖所有业务场景，Agent会自动收集运行过程中用到的所有反射、资源、JNI等元数据配置，避免手动配置漏项。

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