迁移Spring Boot应用到Quarkus时私有Spring Boot依赖报空指针如何处理

问题根因 #

你碰到的NPE本质是Quarkus默认不会自动扫描、实例化Spring体系下的Bean（比如带@Component/@ConfigurationProperties/@Autowired注解的类），私有依赖里的配置类和业务Bean没有被Quarkus容器初始化，所以调用时直接空指针。

可选方案（无需全量迁移私有依赖的方案优先） #

不需要直接修改私有依赖的方案可覆盖绝大多数场景，优先选择：

方案1：启用Quarkus Spring兼容扩展 #

Quarkus官方提供了一系列Spring API兼容扩展，不需要修改私有依赖代码就能直接兼容大多数Spring注解能力：

• 首先在项目pom.xml/build.gradle里引入对应扩展：
  • 基础Spring DI兼容：quarkus-spring-di
  • Spring配置属性兼容：quarkus-spring-boot-properties
  • 如果用到其他Spring能力比如Web、Data，可以对应引入quarkus-spring-web、quarkus-spring-data-jpa等
• 在application.yaml里添加配置，开启对第三方依赖包里Spring Bean的扫描：

  quarkus:
    spring:
      di:
        scan-packages:
          - 你私有依赖的根包名
  

• 原有私有依赖里的@ConfigurationProperties配置不需要改动，Quarkus会自动读取yaml里的对应配置注入到类里
• 优缺点：改造成本极低，不需要动私有依赖代码，90%以上的普通Spring Bean场景都能直接兼容；缺点是如果私有依赖用到了比较偏门的Spring SPI扩展、或者Spring Boot特有的自动配置类（@AutoConfiguration），可能存在兼容问题

方案2：手动注册Bean到Quarkus容器 #

如果兼容扩展覆盖不到你的私有依赖场景，可以手动在你的Quarkus项目里声明Bean实例，不需要修改私有依赖：

• 新建一个配置类，用Quarkus的@Produces注解主动实例化私有依赖的类：

  @ApplicationScoped
  public class PrivateDependencyConfig {
      // 先注入配置
      @ConfigProperty(name = "私有依赖配置的前缀.属性1")
      String property1;
      @ConfigProperty(name = "私有依赖配置的前缀.属性2")
      Integer property2;
      
      @Produces
      @ApplicationScoped
      public 私有依赖的类名 initPrivateBean() {
          私有依赖的类名 bean = new 私有依赖的类名();
          // 手动把配置set到实例里
          bean.setProperty1(property1);
          bean.setProperty2(property2);
          return bean;
      }
  }
  

• 之后在你项目代码里就可以直接用@Inject注入这个类的实例使用
• 优缺点：灵活性最高，完全不依赖Spring兼容层，原生适配Quarkus；缺点是如果私有依赖的类依赖的其他Bean比较多，手动初始化的工作量会比较大

方案3：迁移适配私有依赖到Quarkus #

如果前面两个方案都不能满足需求（比如私有依赖用了大量Spring Boot特有能力，或者需要做原生镜像编译），再考虑迁移私有依赖：

• 把私有依赖里的Spring注解替换为CDI标准注解/Quarkus原生注解：比如@Component替换为@ApplicationScoped，@Autowired替换为@Inject，@ConfigurationProperties替换为@ConfigMapping
• 去掉Spring Boot Starter相关依赖，改为适配Quarkus的依赖
• 优缺点：适配最彻底，性能最好，完美支持Quarkus原生镜像；缺点是改造成本最高，需要修改私有依赖的代码，还要做全量回归测试

选型建议 #

优先试方案1，绝大多数场景都能直接解决问题，改造成本几乎为0；如果碰到个别不兼容的类，搭配方案2手动注册即可；只有当你需要把私有依赖也作为公共组件给其他Quarkus项目使用的时候，再考虑方案3全量适配。

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