Spring Java项目GraalVM nativeTest执行失败问题求助

1. 替换CGLIB代理为JDK动态代理 #

GraalVM Native Image不支持运行时CGLIB字节码增强，需让Spring优先使用JDK动态代理：

• 在@EnableTransactionManagement或@EnableAspectJAutoProxy注解中设置proxyTargetClass = false（若此前显式设为true需修改，默认值即为false）
• 或通过全局配置文件（application.yml/application.properties）统一设置：

  spring:
    aop:
      proxy-target-class: false
  

  此配置会避免Spring尝试生成CGLIB代理类，解决最初的UnsupportedOperationException。你之前注册CglibAutoProxyConfiguration的JDK代理属于错误操作——该类是配置类而非代理目标类，反而会干扰AOT处理流程。

2. 修复AOT初始化失败问题 #

nativeTest依赖测试代码的AOT预处理，按以下步骤排查：

• 先执行gradle testAotGenerate生成测试的AOT配置类，确认该任务无报错
• 检查测试类是否符合Spring Native要求：
  • 禁止使用运行时动态生成的类（如CGLIB代理）
  • 确保所有需要代理的Bean都实现了接口（JDK代理要求目标类必须实现接口）
• 若testAotGenerate报错，查看日志定位未被AOT处理的类，在RuntimeHintsRegistrar中补充注册：

  @RuntimeHints
  public class AuthServiceRuntimeHints implements RuntimeHintsRegistrar {
      @Override
      public void registerHints(RuntimeHints hints, ClassLoader classLoader) {
          // 注册需要代理的接口类
          hints.proxies().registerJdkProxy(GroupControllerInterface.class);
          // 按需注册其他需要反射、资源访问的类
      }
  }
  

3. 修复Native Image构建失败问题 #

• 移除此前错误的registerJdkProxy(TransactionAutoConfiguration.EnableTransactionManagementConfiguration.CglibAutoProxyConfiguration.class)配置，该类无需被代理
• 确保AOT生成的类被正确纳入构建路径，执行gradle nativeCompile前先完成processAot等前置任务
• 查看构建日志中的具体错误，通常是缺少反射、资源或代理注册，根据日志补充RuntimeHints配置

额外注意事项 #

• 建议使用Spring Boot 3.x及以上版本，对GraalVM Native Image的支持更完善
• 所有需代理的业务类必须实现接口，JDK动态代理仅支持接口代理
• 测试中避免依赖运行时动态增强特性，如部分Mockito的mock方式，需调整为接口mock

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