Maven插件开发：如何向MavenProject添加依赖并同步至本地

一、新增依赖未同步的核心问题 #

maven-dependency-plugin的copy-dependencies目标依赖的是Maven已完成解析的依赖结果，你直接修改project.getDependencyArtifacts()只是改动了内存中的集合，完全没有触发Maven重新解析依赖的流程，所以插件根本识别不到新增的依赖，自然不会去下载。

二、正确扩展依赖列表的步骤 #

要让新增依赖被Maven识别并参与解析，得从修改Dependency集合入手，而非直接操作Artifact，具体操作如下：

1. 创建标准的Dependency对象 #

不要直接构建Artifact，先创建符合Maven规范的Dependency对象：

Dependency poiDependency = new Dependency();
poiDependency.setGroupId("org.apache.poi");
poiDependency.setArtifactId("poi");
poiDependency.setVersion("5.1.0");
poiDependency.setScope(Artifact.SCOPE_COMPILE);
poiDependency.setType("jar");

2. 添加依赖并触发重新解析 #

把新依赖加入项目的依赖列表，然后强制Maven重新解析所有依赖，这样新增依赖才会被纳入解析链：

// 复制现有依赖列表并添加新依赖
List<Dependency> dependencies = new ArrayList<>(project.getDependencies());
dependencies.add(poiDependency);
project.setDependencies(dependencies);

// 调用Maven依赖收集器重新解析依赖
DefaultDependencyCollector dependencyCollector = new DefaultDependencyCollector();
DependencyCollectionResult result = dependencyCollector.collectDependencies(
    session,
    new DependencyCollectorRequest(
        project,
        project.getRemoteProjectRepositories(),
        null
    )
);

// 用官方API更新项目的解析结果（替代废弃方法）
ProjectHelper projectHelper = componentLookup(ProjectHelper.class);
projectHelper.setProjectArtifacts(project, new HashSet<>(result.getArtifacts()));

3. 调整插件调用逻辑 #

建议升级maven-dependency-plugin到3.6.0及以上版本，避免旧版本的兼容性问题，调用代码调整如下：

executeMojo(
    plugin(
        groupId("org.apache.maven.plugins"),
        artifactId("maven-dependency-plugin"),
        version("3.6.0")
    ),
    goal("copy-dependencies"),
    configuration(
        element(name("outputDirectory"), unpackDependenciesDirectory.getAbsolutePath()),
        element(name("includeTypes"), "jar"),
        element(name("includeScope"), "compile")
    ),
    executionEnvironment(project, session, buildPluginManager)
);

三、关于setDependencyArtifacts方法废弃的说明 #

这个方法被废弃的核心原因是：Artifact集合是Maven依赖解析后的结果产物，而非可直接修改的输入项。直接修改该集合会绕过Maven的依赖冲突检测、传递依赖解析等核心逻辑，导致项目状态混乱。

替代方案就是上面提到的：

• 操作project.getDependencies()作为依赖输入源
• 通过DependencyCollector重新解析获取合法的Artifact集合
• 用ProjectHelper.setProjectArtifacts()更新项目的解析结果

额外提醒 #

• 插件要绑定到合适的生命周期阶段，比如initialize或process-resources，必须在Maven默认的依赖解析阶段之后、调用copy-dependencies之前执行
• 如果需要保留传递依赖，确保Dependency的transitive属性为true（默认就是true，无需额外修改）
• 尽量使用Maven官方提供的API操作核心对象，不要直接修改内部状态，避免版本兼容性问题

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