如何为自定义Maven插件在中央仓库生成并发布G级maven-metadata.xml

核心机制说明 #

中央仓库的分组（G）级别maven-metadata.xml不是由发布插件生成上传的，这和本地仓库maven-metadata-local.xml的即时生成逻辑完全不同。该文件是中央仓库后台系统定期（通常数小时至24小时）自动聚合生成的，不属于发布阶段需要提交的内容。

先排查项目配置是否合规 #

你已经确认了maven-plugin打包类型和Maven版本（3.9.6）没问题，再检查以下关键配置：

• 确保所有发布的插件模块使用统一的顶级groupId，仓库只会为同一顶级分组聚合元数据
• 检查central-publishing-maven-plugin配置是否覆盖签名、Staging等必要步骤：

  <plugin>
    <groupId>org.sonatype.central</groupId>
    <artifactId>central-publishing-maven-plugin</artifactId>
    <version>0.4.0</version>
    <extensions>true</extensions>
    <configuration>
      <publishing>
        <maven>
          <signing>
            <active>true</active>
          </signing>
          <stagingProfileId>你的Staging Profile ID</stagingProfileId>
        </maven>
      </publishing>
    </configuration>
  </plugin>
  

• 确认Staging仓库已成功close并release，只有release后的构件才会进入中央仓库正式存储区，触发元数据聚合流程

关于central-publishing-maven-plugin的功能边界 #

这个插件的作用是简化中央仓库发布流程（处理签名、校验文件生成、Staging操作），它本身不负责生成或上传G级元数据，这是中央仓库服务器端的职责，不存在功能缺失或Bug，属于正常设计逻辑。

验证与等待策略 #

1. 先通过Maven中央仓库搜索确认你的插件已成功发布（搜索groupId+artifactId）
2. 等待仓库后台的元数据聚合任务执行，首次发布新分组的构件可能需要24小时左右
3. 若超过24小时仍未生成：
   • 检查该分组下是否有至少一个构件的有效版本（仓库仅为存在有效构件的分组生成元数据）
   • 登录Sonatype Nexus后台管理页面查看构件发布状态，排查是否有未处理的异常

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