使用OpenRewrite添加Maven依赖时触发NPE，如何排查根因？

问题背景 #

在Mac OS命令行环境下，使用4.46.0版本的rewrite-maven-plugin在多模块Maven项目中运行自定义Recipe，执行命令如下：

mvn -U org.openrewrite.maven:rewrite-maven-plugin:run -e -Drewrite.activeRecipes=com.xxx.upgrade_18

自定义Recipe的rewrite.yml配置：

type: specs.openrewrite.org/v1beta/recipe
name: com.xxx.upgrade_18
displayName: XXXX
recipeList:
  - org.openrewrite.maven.AddDependency:
      groupId: com.xxx.yyy
      artifactId: zzzz
      version: 9.9.0

运行时触发空指针异常（NPE），堆栈信息：

at org.openrewrite.internal.StringUtils.aspectjNameToPattern (StringUtils.java:647)
    at org.openrewrite.java.search.UsesType.<init> (UsesType.java:33)
    at org.openrewrite.maven.AddDependency.getApplicableTest (AddDependency.java:156)
    at org.openrewrite.Recipe.getApplicableTests (Recipe.java:395)

排查步骤 #

1. 检查项目中的异常Java文件 #

堆栈显示异常出现在AspectJ类名转正则的逻辑中，说明插件遍历项目文件时遇到了无法正常解析的类信息：

• 排查所有模块中是否存在空Java文件、语法错误文件（如缺失类定义、乱码、不完整的代码）
• 确认模块的源代码目录配置是否正常（比如pom.xml中sourceDirectory是否指向有效路径，src/main/java下是否存在可解析的Java类）

2. 显式指定AddDependency的触发条件 #

AddDependency默认会自动生成UsesType检查来判断是否需要添加依赖，未指定onlyIfUsing时可能触发插件内部的异常扫描逻辑。可以显式配置该参数，指定依赖中的某个类，避免自动扫描：

type: specs.openrewrite.org/v1beta/recipe
name: com.xxx.upgrade_18
displayName: XXXX
recipeList:
  - org.openrewrite.maven.AddDependency:
      groupId: com.xxx.yyy
      artifactId: zzzz
      version: 9.9.0
      onlyIfUsing: com.xxx.yyy.zzzz.SomeClass # 替换为依赖包中实际存在的类

如果不需要条件判断，也可以指定一个项目中肯定存在的类，强制插件执行添加操作。

3. 缩小范围定位问题模块 #

由于是多模块项目，先单独在子模块中执行命令，定位出问题的模块：

cd 目标子模块路径
mvn -U org.openrewrite.maven:rewrite-maven-plugin:run -e -Drewrite.activeRecipes=com.xxx.upgrade_18

找到异常模块后，再深入检查该模块的文件结构和代码质量。

4. 升级插件版本 #

4.46.0版本可能存在已知的空指针bug，尝试升级到较新的稳定版本（如最新的4.x系列版本），验证是否已修复该问题。

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