• 日期: 2026-08-16
  • 标签: 程序员

前言

本文记录 2026 年使用 Sonatype Central Publisher Portal 发布 Java/Maven 项目的完整流程。

本文已经不再使用旧版的 issues.sonatype.org、s01.oss.sonatype.org、Staging Repository、Close/Release 等旧流程，而是使用目前 Sonatype 官方推荐的 Central Publisher Portal + central-publishing-maven-plugin 方案。

本文以 Windows + JDK 21 + Maven + GnuPG/Kleopatra 为例。

发布 Maven Central 的完整流程

现在发布一个 Java 项目到 Maven Central，大致分成下面几个步骤：

1. 注册 Sonatype Central Portal
        ↓
2. 创建并验证 Namespace
        ↓
3. 安装 GnuPG / Kleopatra
        ↓
4. 创建 GPG 密钥
        ↓
5. 将 GPG 公钥发布到公共 Key Server
        ↓
6. Maven POM 配置
        ↓
7. 配置 Central User Token
        ↓
8. mvn clean deploy
        ↓
9. Central Portal 自动验证
        ↓
10. Publish
        ↓
11. Maven Central 同步完成

Sonatype 当前的 Maven 发布方式使用 central-publishing-maven-plugin，执行 mvn deploy 后会生成 bundle 并上传到 Central Publisher Portal，然后进行验证。

准备工作

1.环境

本文案例使用：

JDK 21
Maven 3.9+

2.一个公开的代码仓库

项目最好拥有公开的 GitHub、Gitee、GitLab 等代码仓库。

例如：

项目：
yhchat-sdk-core

代码仓库：
Gitee / GitHub

Central 对 Namespace 有明确的归属验证要求。

如果使用 Gitee、GitHub 等代码托管平台，也可以按照 Central 当前支持的规则申请对应 Namespace。

一、注册 Sonatype Central Portal

访问：Sonatype Central Portal

登录或者注册账号，账号和Gitee或者Github的账号保持一致。

注意：

以前很多教程会让你访问 issues.sonatype.org 创建 JIRA 工单。

2026 年新项目不需要再按照这种旧教程操作。

当前应该使用 Central Publisher Portal 管理 Namespace 和发布。

二、创建并验证 Namespace

1.创建

登录 Central Portal 后，进入自己的 Namespace 管理页面。

通常可以从右上角账号菜单进入：View Namespaces

然后点击：Register New Namespace

Central 中的 Namespace 可以理解成 Maven 中的顶级 groupId。

例如：cn.daenx

那么以后你的 Maven 项目可以使用：

cn.daenx

Central 要求你证明自己拥有这个 Namespace。

目前主要有两种方式：

  1. DNS 域名验证
  2. GitHub/Gitee/GitLab/Bitbucket 等代码托管平台对应的 Namespace 验证

Central 官方目前支持类似：

GitHub：
io.github.你的用户名

Gitee：
io.gitee.你的用户名

GitLab：
io.gitlab.你的用户名

Bitbucket：
io.bitbucket.你的用户名

具体以 Central Portal 当前页面提供的选项为准。

2.使用自己的域名验证 Namespace

如果你拥有域名：example.com，那么可以使用：com.example作为 Namespace。

例如我拥有：daenx.cn，那么可以申请：cn.daenx

申请之后，Central 会生成一个：Verification Key

然后需要去域名 DNS 管理后台增加 TXT 记录。

例如：

类型：TXT

主机记录：
根据 Central 页面提供的信息填写

记录值：
Central 生成的 Verification Key

DNS 生效后回到 Central Portal 点击：Verify Namespace

等待状态变成：Verified即可。

三、获取User Token

Central Publisher Portal 使用 User Token 进行 Maven 发布。

进入：Central User Token 页面

注意：

Token 页面关闭之后，Token 凭证不会再次完整显示，所以生成后一定保存好。

官方文档也明确说明 Token 关闭弹窗后不能重新取回。

image

四、配置Maven settings.xml

找到 Maven：settings.xml
增加：


    
        
            central
            生成的User Token Username
            生成的User Token Password

注意这里：

central

必须和下文的 POM 中：

central

对应。
image

五、安装 GnuPG / Kleopatra

Maven Central 要求发布的文件使用 GPG/PGP 签名。

官方要求每一个部署文件都应该有对应的 .asc 签名文件。

Windows 推荐使用：Gpg4win 官方网站

六、使用 Kleopatra 创建 GPG 密钥

打开 Kleopatra。

选择：文件 → 新建 OpenPGP 密钥对

填写：

姓名：你的名字（建议和Gitee或者Github的账号保持一致）

邮箱：你的邮箱（建议和Gitee或者Github的邮箱保持一致）

例如：

姓名：
DaenMax

邮箱：
1330166565@qq.com

有效期设置长一点

建议给密钥设置一个密码，这个密码是以后 Maven 使用 GPG 签名时需要使用的密码。

⚠️ 这个密码一定要记住。 如果忘记密码，无法恢复。

七、配置 Kleopatra 发布服务器并发布 GPG 公钥

1.配置

这是 Maven Central 发布过程中非常重要的一步。

Central 官方目前支持以下公共 GPG Key Server：

keyserver.ubuntu.com
keys.openpgp.org
pgp.mit.edu

官方文档明确要求将自己的公钥分发到 Key Server，Central 才能通过公钥验证你的签名。

我个人建议使用：

keyserver.ubuntu.com

打开软件，设置→ 配置 Kleopatra→ GnuPG 系统→ Network

找到：use keyserver at URL

这里填写：hkps://keyserver.ubuntu.com

image

2.发布

回到证书列表，右键自己的证书：

在服务器上发布

或者类似：

Export to Keyserver

具体菜单名称可能根据 Kleopatra 版本略有不同。

如果成功，就代表公钥已经发布。

八、配置项目POM

1.基本信息

下面开始配置 Maven 项目。

假设：

groupId：
cn.daenx

artifactId：
yhchat-sdk-core

version：
1.3.0

那么最终 Maven 坐标就是：

cn.daenx:yhchat-sdk-core:1.3.0

POM 必须包含的基本信息
Central 对 Maven POM 有一些强制要求，包括：

  • groupId
  • artifactId
  • version
  • name
  • description
  • url
  • licenses
  • developers
  • scm

官方要求可以参考 Central 的 Requirements 文档。

基本结构：

cn.daenx
yhchat-sdk-core
1.3.0

yhchat-sdk-core


    yhchat-sdk-core 是一个 Java SDK。


https://gitee.com/daenmax/yhchat-sdk-core


    
        Apache License, Version 2.0
        http://www.apache.org/licenses/LICENSE-2.0.txt
        repo
    



    
        DaenMax
        DaenMax
        1330166565@qq.com
    



        scm:git:https://gitee.com/daenmax/yhchat-sdk-core.git
        scm:git:ssh://git@gitee.com/daenmax/yhchat-sdk-core.git
        https://gitee.com/daenmax/yhchat-sdk-core

2.配置生成 Sources.jar插件


    org.apache.maven.plugins
    maven-source-plugin
    3.3.1
    
        
            attach-sources
            package
            
                jar-no-fork

3.配置生成 Javadoc.jar插件

            
                org.apache.maven.plugins
                maven-javadoc-plugin
                3.11.2
                
                    none
                    UTF-8
                    UTF-8
                    UTF-8
                
                
                    
                        attach-javadocs
                        package
                        
                            jar

4.配置 GPG 签名插件


    org.apache.maven.plugins
    maven-gpg-plugin
    3.2.8
    
        
            sign-artifacts
            verify
            
                sign

5.配置 Central Publishing Plugin发布插件

            
                org.sonatype.central
                central-publishing-maven-plugin
                0.11.0
                true
                
                    central
                    false
                    validated
                    all

6.完整 POM 示例

下面给一个可以作为参考的完整结构：



    4.0.0
    
        org.springframework.boot
        spring-boot-starter-parent
        3.5.16
        
    
    cn.daenx
    yhchat-sdk-core
    1.3.0
    jar
    yhchat-sdk-core
    
        yhchat-sdk-core是云湖社交的Java版本的SDK核心服务，通过此Core可以快速构建您的云湖机器人，能让您以非常便捷的方式和云湖服务进行交互。
    
    https://gitee.com/daenmax/yhchat-sdk-core
    
        21
        UTF-8
        UTF-8
        5.8.47
    
    
        
        
            org.springframework.boot
            spring-boot-starter
            true
        
        
            org.springframework.boot
            spring-boot-starter-web
            true
        
        
        
            org.springframework.boot
            spring-boot-starter-test
            test
        
        
        
            org.projectlombok
            lombok
            true
        
        
        
            cn.hutool
            hutool-all
            ${hutool.version}
            true
        
        
        
            org.apache.commons
            commons-lang3
            true
        
    
    
    
    
    
        
            Apache License, Version 2.0
            https://www.apache.org/licenses/LICENSE-2.0.txt
            repo
        
    
    
    
        
            DaenMax
            DaenMax
            1330166565@qq.com
            
                Developer
            
            +8
        
    
    
    
        scm:git:https://gitee.com/daenmax/yhchat-sdk-core.git
        scm:git:ssh://git@gitee.com/daenmax/yhchat-sdk-core.git
        https://gitee.com/daenmax/yhchat-sdk-core
    

    
    
        
            
            
                org.apache.maven.plugins
                maven-compiler-plugin
                
                    ${java.version}
                
            
            
            
                org.apache.maven.plugins
                maven-source-plugin
                3.3.1
                
                    
                        attach-sources
                        package
                        
                            jar-no-fork
                        
                    
                
            
            
            
                org.apache.maven.plugins
                maven-javadoc-plugin
                3.11.2
                
                    none
                    UTF-8
                    UTF-8
                    UTF-8
                
                
                    
                        attach-javadocs
                        package
                        
                            jar
                        
                    
                
            
            
            
                org.apache.maven.plugins
                maven-gpg-plugin
                3.2.8
                
                    
                        sign-artifacts
                        verify
                        
                            sign
                        
                    
                
            
            
            
                org.sonatype.central
                central-publishing-maven-plugin
                0.11.0
                true
                
                    central
                    false
                    validated
                    all

九、执行 Maven Central 发布

打开项目，cmd

mvn clean deploy

新的 Central Publishing Plugin 会接管 deploy 流程，将项目构建结果生成 bundle 并上传到 Central Publisher Portal。

十、进入 Sonatype Central Portal 查看并发布

登录：Sonatype Central Portal

进入Deployments，点击Publish

image

发布成功后，组件会同步到 Maven Central。

十一、发布完成

发布成功后，就可以在 Maven Central 搜索你的组件。

例如：

cn.daenx:yhchat-sdk-core:1.3.0

也可以直接在项目中使用：


    cn.daenx
    yhchat-sdk-core
    1.3.0

至此，就完事了，在 Maven Central 可以立即搜索到

而 Maven Repository大概第二天才能搜索到

（在此期间，无法搜索到也不影响项目中使用坐标引用你的项目）

其他命令参考

# 使用CMD执行

# 安装到本地仓库
mvn clean install -Dgpg.skip=true

# 打包并上传到maven仓库
mvn clean deploy

本文最后更新时间：2026-08-16


原文地址: https://www.cveoy.top/t/topic/qHl1 著作权归作者所有。请勿转载和采集!

免费AI点我,无需注册和登录