在 OpenRewrite 的 JUnit 测试中，若 Recipe 涉及依赖坐标（如 @@@SNAPSHOT@@@）需解析但默认不加载本地仓库，会导致 POM 插入失败注释；解决方法是通过 MavenExecutionContextView 显式配置包含本地仓库的 repositories 列表。
在 openrewrite 的 junit 测试中，若 recipe 涉及依赖坐标（如 `@@@snapshot@@@`）需解析但默认不加载本地仓库，会导致 pom 插入失败注释；解决方法是通过 `mavenexecutioncontextview` 显式配置包含本地仓库的 `repositories` 列表。
OpenRewrite 在测试环境中（如 JUnit）默认不自动加载用户本地 Maven 仓库（~/.m2/repository），也不继承项目构建时的 settings.xml 或 pom.xml 中定义的仓库配置。因此，当你的 Recipe 尝试解析一个仅存在于本地仓库的 SNAPSHOT 版本（例如 <version>@@@SNAPSHOT@@@</version>）时，OpenRewrite 会尝试远程下载其 POM（默认仅访问 Maven Central），失败后便生成形如 <!--~~(c:d:@@@SNAPSHOT@@@ failed. Unable to download POM...)~~>--> 的诊断注释。
要让测试环境识别本地仓库，必须在 rewriteRun() 调用中显式注入自定义的 Maven 执行上下文，并将本地仓库作为 MavenRepository 添加进去。OpenRewrite 提供了便捷的 MavenExecutionContextView 工具类来完成这一操作。
以下是推荐的实现方式（适配 OpenRewrite 8.x+）：
import org.openrewrite.ExecutionContext;
import org.openrewrite.InMemoryExecutionContext;
import org.openrewrite.maven.MavenExecutionContextView;
import org.openrewrite.maven.MavenRepository;
import org.openrewrite.test.RewriteTest;
import org.junit.jupiter.api.Test;
import java.nio.file.Paths;
import static org.openrewrite.maven.Assertions.pomXml;
import static org.openrewrite.test.RewriteTest.rewriteRun;
class MyRecipeTest implements RewriteTest {
@Test
void shouldResolveLocalSnapshotInPom() {
// 构建指向本地仓库的 MavenRepository（路径需根据系统调整）
String localRepoPath = System.getProperty("user.home") + "/.m2/repository";
MavenRepository localRepo = MavenRepository.builder()
.id("local")
.uri(Paths.get(localRepoPath).toUri().toString())
.build();
rewriteRun(
spec -> spec
.recipe(new YourRecipe()) // 替换为你的实际 Recipe 实例
.executionContext(
MavenExecutionContextView.view(new InMemoryExecutionContext())
.setRepositories(List.of(localRepo)) // 关键：注入本地仓库
),
pomXml(
"""
<project>
<modelVersion>4.0.0</modelVersion>
<groupId>test</groupId>
<artifactId>demo</artifactId>
<version>1.0</version>
<dependencies>
<dependency>
<groupId>a</groupId>
<artifactId>b</artifactId>
<version>1.0.0</version>
</dependency>
</dependencies>
</project>
""",
"""
<project>
<modelVersion>4.0.0</modelVersion>
<groupId>test</groupId>
<artifactId>demo</artifactId>
<version>1.0</version>
<dependencies>
<dependency>
<groupId>c</groupId>
<artifactId>d</artifactId>
<version>@@@SNAPSHOT@@@</version>
</dependency>
</dependencies>
</project>
"""
)
);
}
}✅ 关键要点说明：
-
MavenRepository.builder().uri(...)的 URI 必须是有效的文件协议 URL（如file:///Users/you/.m2/repository），Windows 用户注意使用正斜杠和三斜杠前缀（file:///C:/Users/you/.m2/repository）； - 不建议硬编码路径，可复用
System.getProperty("user.home")或通过System.getProperty("maven.repo.local")获取 Maven 配置的仓库路径（若测试运行时已设置该系统属性）； - 若同时需要远程仓库（如私有 Nexus），可将多个
MavenRepository实例一并加入List.of(...)； - 此配置仅作用于当前测试用例的执行上下文，不影响其他测试，符合隔离性原则。
⚠️ 注意事项：
- 确保目标 SNAPSHOT 的
.pom和.jar文件确实存在于本地仓库对应路径（如~/.m2/repository/c/d/1.0.0-SNAPSHOT/d-1.0.0-SNAPSHOT.pom），否则仍会解析失败； - OpenRewrite 不会自动触发
mvn install，请确保 SNAPSHOT 已预先安装到本地仓库； - 若使用 Gradle 构建测试项目，请在
build.gradle中确认test任务未屏蔽本地仓库访问（通常无需额外配置）。
通过上述方式，你就能在 JUnit 测试中精准复现生产环境的依赖解析行为，使 Recipe 测试真正具备端到端可靠性。
