本文介绍在使用 OpenRewrite（如 UpgradeToJava17）时，如何安全排除 Collections.singletonMap 等不兼容 null 键的 API 替换，避免单元测试因 Map.of() 不支持 null 键而失败。
本文介绍在使用 openrewrite（如 `upgradetojava17`）时，如何安全排除 `collections.singletonmap` 等不兼容 `null` 键的 api 替换，避免单元测试因 `map.of()` 不支持 `null` 键而失败。
OpenRewrite 的迁移配方（如 org.openrewrite.java.migrate.UpgradeToJava17）旨在提升代码现代性，但部分转换存在语义风险——典型例子是将 Collections.singletonMap(null, "value") 替换为 Map.of(null, "value")，而后者在运行时抛出 NullPointerException。这类问题已在社区中被明确识别：自 rewrite-migrate-java v2.0.7 起，原 Collections.singletonMap → Map.of 的转换规则已被默认移除（参见 PR #253），从根本上规避了该兼容性陷阱。
✅ 推荐方案：升级依赖
请将 rewrite-migrate-java 升级至 2.0.7 或更高版本（Maven 示例）：
<dependency><groupid>org.openrewrite.recipe</groupid><artifactid>rewrite-migrate-java</artifactid><version>2.0.7</version><!-- 或最新稳定版 --></dependency>
升级后无需额外配置，相关危险替换将自动跳过，单元测试可保持稳定。
⚠️ 备用方案：显式排除（适用于旧版本或自定义场景）
若因项目约束暂无法升级，可通过插件配置 exclusions 精确屏蔽特定调用。以 Maven 为例，在 pom.xml 中为 rewrite-maven-plugin 添加：
<plugin><groupid>org.openrewrite.maven</groupid><artifactid>rewrite-maven-plugin</artifactid><configuration><activerecipes><recipe>org.openrewrite.java.migrate.UpgradeToJava17</recipe></activerecipes><exclusions><!-- 排除所有 Collections.singletonMap 调用 --><exclusion>java.util.Collections#singletonMap(..)</exclusion><!-- 也可细化到具体类/方法签名 --><!-- <exclusion>com.example.MyTest#testNullKeyMap()</exclusion> --></exclusions></configuration></plugin>
Gradle 用户则在 build.gradle 中使用 DSL 配置：
rewrite {
activeRecipe("org.openrewrite.java.migrate.UpgradeToJava17")
exclusions = ["java.util.Collections#singletonMap(..)"]
}
? 注意事项：
-
exclusions支持通配符和完整方法签名（如#method(paramType)），建议优先使用精确签名以避免误排除； - 排除仅作用于匹配的 AST 节点，不影响其他同名方法或重载；
- 始终在应用变更前运行
mvn rewrite:dryRun或./gradlew rewriteDryRun验证效果； - 长期维护建议以升级依赖为首选，既减少配置负担，又同步获取社区修复与新特性。
通过合理选择升级或排除策略，您可在享受 OpenRewrite 自动化红利的同时，确保关键测试逻辑与业务语义零妥协。
