运行UpgradeSpringBoot_3_0配方时出现配置警告及空指针异常

问题场景 #

执行以下Maven命令触发空指针警告：

mvn -U org.openrewrite.maven:rewrite-maven-plugin:dryRun   -Drewrite.recipeArtifactCoordinates=org.openrewrite.recipe:rewrite-spring:RELEASE   -Drewrite.activeRecipes=org.openrewrite.java.spring.boot3.UpgradeSpringBoot_3_0

错误日志 #

[WARNING] Unable to configure org.openrewrite.java.spring.framework.UpgradeSpringFrameworkDependencies
java.lang.NullPointerException: Cannot invoke "String.startsWith(String)" because "this.newVersion" is null
    at org.openrewrite.java.spring.framework.UpgradeSpringFrameworkDependencies.getRecipeList (UpgradeSpringFrameworkDependencies.java:84)
    at org.openrewrite.Recipe.createRecipeDescriptor (Recipe.java:152)
    at org.openrewrite.Recipe.getDescriptor (Recipe.java:144)
    at org.openrewrite.config.ClasspathScanningLoader.configureRecipes (ClasspathScanningLoader.java:166)
    at org.openrewrite.config.ClasspathScanningLoader.scanClasses (ClasspathScanningLoader.java:135)
....................
....................

问题根源 #

UpgradeSpringFrameworkDependencies配方初始化失败，核心原因是newVersion参数未被正确赋值（为null），导致调用String.startsWith()方法时触发空指针异常。

解决步骤 #

• 指定明确的rewrite-spring版本
  避免使用RELEASE这种动态版本标识，改用稳定的具体版本（例如5.40.0，可根据官方最新稳定版调整）：

  mvn -U org.openrewrite.maven:rewrite-maven-plugin:dryRun -Drewrite.recipeArtifactCoordinates=org.openrewrite.recipe:rewrite-spring:5.40.0 -Drewrite.activeRecipes=org.openrewrite.java.spring.boot3.UpgradeSpringBoot_3_0
  

  动态版本可能拉取到存在参数处理bug的迭代版本，明确版本可规避这类问题。

• 确保项目存在Spring Boot基础依赖配置
  检查项目pom.xml是否已声明Spring Boot父依赖或依赖管理块，例如：

  <parent>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-parent</artifactId>
      <version>2.7.14</version> <!-- 升级前的基线版本 -->
      <relativePath/>
  </parent>
  

  升级配方需要读取现有Spring Boot版本来推导目标版本，缺失该配置会导致版本参数为空。

• 同步升级rewrite-maven-plugin版本
  使用与rewrite-spring版本一致的插件版本，避免版本不兼容：

  mvn -U org.openrewrite.maven:rewrite-maven-plugin:5.40.0:dryRun -Drewrite.recipeArtifactCoordinates=org.openrewrite.recipe:rewrite-spring:5.40.0 -Drewrite.activeRecipes=org.openrewrite.java.spring.boot3.UpgradeSpringBoot_3_0
  

  新版本插件通常修复了这类参数初始化的bug。

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