Sonatype Nexus Staging Maven插件在多模块项目中跳过子模块部署的解决方案

问题背景

在使用Sonatype Nexus Staging Maven插件(nexus-staging-maven-plugin)进行多模块Maven项目部署时，开发者可能会遇到一个常见问题：无法通过传统的maven.deploy.skip属性来跳过特定子模块的部署。这个问题在DFLib DataFrame项目中就曾出现，其中dflib-benchmark模块虽然设置了跳过部署的属性，但仍然被发布到了Sonatype仓库中。

传统方法的局限性

在标准的Maven部署流程中，开发者通常使用以下两种方式来跳过模块部署：

1. 在模块的pom.xml中设置属性：

<properties>
    <maven.deploy.skip>true</maven.deploy.skip>
</properties>

2. 显式配置maven-deploy-plugin：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-deploy-plugin</artifactId>
    <configuration>
        <skip>true</skip>
    </configuration>
</plugin>

然而，当使用Nexus Staging Maven插件时，这些方法可能不再有效，因为该插件接管了部署流程，绕过了标准部署插件的配置。

解决方案：使用excludeArtifacts配置

针对Nexus Staging Maven插件，正确的解决方案是使用其提供的excludeArtifacts配置项。这个配置允许开发者明确指定要排除的artifact ID列表。

配置示例：

<plugin>
    <groupId>org.sonatype.plugins</groupId>
    <artifactId>nexus-staging-maven-plugin</artifactId>
    <extensions>true</extensions>
    <configuration>
        <serverId>oss-sonatype-releases</serverId>
        <nexusUrl>https://s01.oss.sonatype.org/</nexusUrl>
        <autoReleaseAfterClose>false</autoReleaseAfterClose>
        <excludeArtifacts>
            <artifact>dflib-benchmark</artifact>
        </excludeArtifacts>
    </configuration>
</plugin>

最佳实践建议

1. 明确排除：对于多模块项目，建议在父POM中明确列出所有需要排除的子模块artifact ID，而不是依赖全局属性。

2. 版本兼容性：确保使用的插件版本支持excludeArtifacts配置项。较新版本的插件通常有更好的兼容性和功能支持。

3. 测试验证：在正式发布前，使用mvn deploy -DdryRun=true命令进行测试，验证排除配置是否生效。

4. 考虑迁移：随着Sonatype发布流程的更新，建议评估迁移到新的central-publishing-maven-plugin的可能性，该插件提供了更现代的配置方式。

技术原理

Nexus Staging Maven插件通过扩展Maven的部署机制，提供了更精细的发布控制。当配置了excludeArtifacts时，插件会在构建部署描述符时过滤掉指定的artifact，从而确保它们不会被上传到远程仓库。这种机制比传统的跳过属性更加可靠，因为它直接作用于部署流程的核心环节。

通过理解这一机制，开发者可以更有效地控制多模块项目的发布内容，确保只有预期的模块被部署到中央仓库。