多模块Maven项目中，如何将构件附加到已构建的根项目？

问题根源 #

Maven多模块构建遵循反应堆执行顺序：根项目的核心生命周期阶段（如install）会先于所有子模块完成。当你在最后一个子模块的compile阶段向根项目附加构件时，根项目的install步骤早已执行完毕，Maven不会再重新将根项目的新构件同步到本地仓库。而附加到当前子模块时，该子模块的install阶段尚未执行，因此构件能被正常安装到仓库。

可行解决方案 #

方案1：将插件绑定到根项目的晚生命周期阶段

直接在根项目中配置插件，绑定到verify或install阶段（这两个阶段会在所有子模块构建完成后执行），在该阶段完成文件合并并附加构件到根项目。这样根项目的install阶段会自动将新构件同步到仓库。

实现要点：

• 在根项目的pom.xml中配置插件，指定<phase>verify</phase>
• 插件逻辑中通过mavenSession.getProjects()获取所有子模块，遍历它们的target目录收集文件
• 合并文件后，调用projectHelper.attachArtifact()附加到根项目（此时根项目的install阶段尚未执行）

示例代码片段（插件Mojo核心逻辑）：

@Mojo(name = "merge-and-attach", defaultPhase = LifecyclePhase.VERIFY)
public class MergeAttachMojo extends AbstractMojo {
    @Parameter(defaultValue = "${mavenSession}", readonly = true)
    private MavenSession mavenSession;

    @Component
    private MavenProjectHelper projectHelper;

    @Parameter(defaultValue = "${project}", readonly = true)
    private MavenProject currentProject;

    public void execute() throws MojoExecutionException {
        // 仅在根项目执行
        if (!currentProject.isExecutionRoot()) {
            return;
        }

        // 遍历所有子模块，收集target目录文件
        List<MavenProject> subProjects = mavenSession.getProjects().stream()
                .filter(p -> !p.isExecutionRoot())
                .collect(Collectors.toList());

        // 合并文件逻辑（自行实现）
        File mergedFile = mergeFilesFromSubModules(subProjects);

        // 附加构件到根项目
        projectHelper.attachArtifact(currentProject, "zip", "merged", mergedFile);
    }
}

方案2：在最后一个子模块中手动安装根项目构件

如果必须在最后一个子模块执行合并操作，可以调用Maven的install:install-file目标，手动将合并后的构件安装到本地仓库，关联根项目的GAV信息。

实现要点：

• 在插件中执行InstallFileMojo，传入根项目的groupId、artifactId、version
• 指定合并后的文件路径、构件类型和分类器

示例代码片段（插件中调用install-file）：

@Mojo(name = "merge-install", defaultPhase = LifecyclePhase.COMPILE)
public class MergeInstallMojo extends AbstractMojo {
    @Parameter(defaultValue = "${mavenSession}", readonly = true)
    private MavenSession mavenSession;

    @Component
    private MavenProjectHelper projectHelper;

    @Parameter(defaultValue = "${project}", readonly = true)
    private MavenProject currentProject;

    public void execute() throws MojoExecutionException {
        // 判断是否是最后一个子模块
        List<MavenProject> reactorProjects = mavenSession.getProjects();
        if (!currentProject.equals(reactorProjects.get(reactorProjects.size() - 1))) {
            return;
        }

        // 合并文件逻辑（自行实现）
        File mergedFile = mergeFilesFromAllModules(reactorProjects);

        // 获取根项目GAV
        MavenProject rootProject = mavenSession.getTopLevelProject();
        String groupId = rootProject.getGroupId();
        String artifactId = rootProject.getArtifactId();
        String version = rootProject.getVersion();

        // 调用install:install-file安装构件到根项目GAV
        InstallFileMojo installMojo = new InstallFileMojo();
        installMojo.setGroupId(groupId);
        installMojo.setArtifactId(artifactId);
        installMojo.setVersion(version);
        installMojo.setFile(mergedFile);
        installMojo.setPackaging("zip");
        installMojo.setClassifier("merged");
        installMojo.setLocalRepository(mavenSession.getLocalRepository());
        installMojo.setRepositorySession(mavenSession.getRepositorySession());

        try {
            installMojo.execute();
        } catch (MojoExecutionException | MojoFailureException e) {
            throw new MojoExecutionException("Failed to install merged artifact to root project", e);
        }
    }
}

总结 #

优先选择方案1，它符合Maven的生命周期设计逻辑，无需额外手动操作，能确保构件自然同步到本地仓库。如果因需求限制必须在子模块中执行，再考虑方案2。

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