Spring Native(Spring Boot3.0.5)结合GraalVM运行时加载可选框架类失败

核心问题分析 #

AOT模式下Spring的Bean定义是提前编译阶段生成的，而你在BeanFactoryPostProcessor中调用scanner.scan()属于运行时动态扫描，这种逻辑无法被GraalVM的AOT编译器提前处理，进而触发了未预加载的可选类（如PersistenceAnnotationBeanPostProcessor）加载失败，即使添加RuntimeHints也无法完全覆盖动态扫描带来的类加载问题。

具体解决步骤 #

1. 替换动态扫描方式，改用AOT友好的ImportBeanDefinitionRegistrar #

放弃在BeanFactoryPostProcessor中调用扫描，改用ImportBeanDefinitionRegistrar实现自定义Bean注册，该接口的逻辑会在AOT编译阶段被解析，GraalVM能提前生成相关Bean定义：

public class RpcComponentRegistrar implements ImportBeanDefinitionRegistrar, ResourceLoaderAware {
    private ResourceLoader resourceLoader;

    @Override
    public void setResourceLoader(ResourceLoader resourceLoader) {
        this.resourceLoader = resourceLoader;
    }

    @Override
    public void registerBeanDefinitions(AnnotationMetadata importingClassMetadata, BeanDefinitionRegistry registry) {
        RpcComponentScanner scanner = new RpcComponentScanner(registry);
        scanner.setResourceLoader(this.resourceLoader);
        // 指定要扫描的自定义注解
        scanner.addIncludeFilter(new AnnotationTypeFilter(MyRPCService.class));
        // 替换为你的实际扫描包路径
        scanner.scan("com.your.rpc.service.package");
    }
}

然后在Spring Boot启动类上添加@Import注解引入这个注册器：

@SpringBootApplication
@Import(RpcComponentRegistrar.class)
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

2. 完善RuntimeHintsRegistrar的注册逻辑 #

确保不仅注册报错的JPA类，还要覆盖自定义扫描涉及的所有类和资源：

public class RpcRuntimeHints implements RuntimeHintsRegistrar {
    @Override
    public void registerHints(RuntimeHints hints, ClassLoader classLoader) {
        // 注册JPA可选类，允许反射和类加载
        hints.reflection().registerType(PersistenceAnnotationBeanPostProcessor.class,
                hint -> hint.withPublicConstructors().withPublicMethods().withPublicFields());
        // 注册自定义注解类
        hints.reflection().registerType(MyRPCService.class,
                hint -> hint.withPublicConstructors().withPublicMethods());
        // 注册扫描包下的所有类资源，确保AOT能找到
        hints.resources().registerPattern("com/your/rpc/service/package/**/*.class");
    }
}

在启动类上引入该Hints：

@SpringBootApplication
@Import(RpcComponentRegistrar.class)
@ImportRuntimeHints(RpcRuntimeHints.class)
public class YourApplication {
    // ...
}

3. 排除未使用的JPA自动配置（如果项目不依赖JPA） #

如果你的项目根本不需要JPA功能，直接排除JPA的自动配置类，从根源避免触发该类的加载：

@SpringBootApplication(exclude = HibernateJpaAutoConfiguration.class)
@Import(RpcComponentRegistrar.class)
@ImportRuntimeHints(RpcRuntimeHints.class)
public class YourApplication {
    // ...
}

或者在application.properties中添加：

spring.autoconfigure.exclude=org.springframework.boot.autoconfigure.orm.jpa.HibernateJpaAutoConfiguration

4. 检查自定义扫描器的AOT兼容性 #

确保你的RpcComponentScanner重写的方法（如isCandidateComponent）中没有使用动态类加载、反射等未被AOT处理的逻辑，所有涉及的类都要在RuntimeHints中注册。

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