Spring Boot 3.2.1下如何在Spring Native中批量注册反射类？

针对OpenAPI生成的多态类无法被Spring自动检测反射信息的问题，在业务对象库中实现批量包扫描注册的可行方案有两种：

方案1：使用@NativeHint通配符快速配置 #

这是最简洁的实现方式，直接通过Spring Native的@NativeHint注解指定目标包的所有类，一次性注册Jackson序列化/反序列化所需的反射信息：

import org.springframework.context.annotation.Configuration;
import org.springframework.nativex.hint.AccessBits;
import org.springframework.nativex.hint.NativeHint;
import org.springframework.nativex.hint.TypeHint;

@Configuration
@NativeHint(
    types = {
        @TypeHint(
            // 替换为你的OpenAPI生成类所在根包，**包含所有子包
            typeNames = "com.your.openapi.generated.models.**",
            // 注册所有声明的构造方法、字段、方法，覆盖Jackson的反射需求
            access = AccessBits.ALL_DECLARED_CONSTRUCTORS,
            fields = AccessBits.ALL_DECLARED_FIELDS,
            methods = AccessBits.ALL_DECLARED_METHODS
        )
    }
)
public class OpenApiReflectionAutoConfiguration {
}

将该配置类放在业务对象库中，其他Spring Boot应用引入库后，原生镜像构建时会自动为指定包下的所有类注册反射信息。

方案2：自定义RuntimeHintsRegistrar实现灵活扫描 #

如果需要更精细的扫描规则（比如只注册带特定注解的类、排除某些类），可以实现Spring的RuntimeHintsRegistrar接口，自定义包扫描逻辑：

import org.springframework.aot.hint.RuntimeHints;
import org.springframework.aot.hint.RuntimeHintsRegistrar;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.ImportRuntimeHints;
import org.springframework.context.annotation.ClassPathScanningCandidateComponentProvider;
import org.springframework.util.ClassUtils;

import java.util.Set;

@Configuration
@ImportRuntimeHints(OpenApiModelReflectionHints.class)
public class OpenApiReflectionAutoConfiguration {
}

class OpenApiModelReflectionHints implements RuntimeHintsRegistrar {
    // 替换为你的OpenAPI生成类所在根包
    private static final String TARGET_PACKAGE = "com.your.openapi.generated.models";

    @Override
    public void registerHints(RuntimeHints hints, ClassLoader classLoader) {
        // 初始化Spring类扫描器
        ClassPathScanningCandidateComponentProvider scanner = new ClassPathScanningCandidateComponentProvider(false);
        // 自定义过滤规则：示例为扫描所有类，可替换为只扫描带特定注解的类
        scanner.addIncludeFilter((metadataReader, metadataReaderFactory) -> true);

        // 扫描目标包下的所有候选类
        Set<org.springframework.beans.factory.config.BeanDefinition> candidates = scanner.findCandidateComponents(TARGET_PACKAGE);
        for (var candidate : candidates) {
            try {
                Class<?> clazz = ClassUtils.forName(candidate.getBeanClassName(), classLoader);
                // 为类注册反射信息，包含构造方法、字段、方法
                hints.reflection().registerType(clazz, typeHint ->
                        typeHint.withConstructor()
                                .withFields()
                                .withMethods()
                );
            } catch (ClassNotFoundException e) {
                throw new RuntimeException("Failed to register reflection hints for class: " + candidate.getBeanClassName(), e);
            }
        }
    }
}

这种方式可以根据需求调整扫描逻辑，比如如果你的OpenAPI生成类带有自定义标记注解（通过OpenAPI Generator添加），可以修改过滤规则只扫描带该注解的类，进一步缩小范围。

注意事项 #

1. 确保库中的配置类能被Spring Boot应用自动扫描到：可以通过@ComponentScan，或者在库的META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports文件中配置该配置类的全路径，实现自动装配。
2. 原生镜像构建时，确保业务对象库的JAR包被正确包含到构建流程中。

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