往maven中央仓库发布自己的jar包，踩坑实录

踩坑感想

java程序员咋能没有jar包在maven中央仓库呢？抱着这样的心态我准备把自己的一个小项目发布到maven中央仓库。虽然网上的教程很多，但是嘛，总有意外，所以记录下我的踩坑过程。

向maven中央仓库发布自己的jar包的基本步骤

因为maven不能直接向中央仓库发布jar包，而是向和maven合作的第三方仓库发布，然后再由第三方仓库把jar同步到中央仓库。我们今天用的第三方仓库是sonatype。下面就是主要步骤：

1.要往sonatype发布jar包，第一步先要向注册一个sonatype的账号

注册地址：https://issues.sonatype.org/secure/Signup!default.jspa

需要填写Email, Full Name, Username以及password，其中Username与Password后面的步骤需要用到，请记下来。

2.申请一个issue

（1）新建一个issue

通过创建issue来申请发布新的jar包，Sonatype的工作人员会进行审核，审核不算严格，一般按照要求填写不会有问题。

创建链接：https://issues.sonatype.org/secure/CreateIssue.jspa

• 创建issue.png

• 下一步.png

新建页面.png

创建issue的时候需要填写下面这些信息：

• Description 项目描述

• Group Id 组织名

• Project URL 在代码管理平台（类似GitHub，gitee）项目的地址

• SCM url 项目的git地址

可以参考下我发布的orange项目

（2）等待 Issue 审批

审核通过后会收到邮件通知，同时在 Issue 下面会看到 Sonatype 工作人员的回复，一般是添加一个 scomment，内容大致如下：

com.gitee.zimmor has been prepared, now user(s) zimmor can:
 Publish snapshot and release artifacts to s01.oss.sonatype.org
 Have a look at this section of our official guide for deployment instructions:
 https://central.sonatype.org/publish/publish-guide/#deployment
 
  
Depending on your build configuration, your first component(s) might be released automatically after a successful deployment.
 If that happens, you will see a comment on this ticket confirming that your artifact has synced to Maven Central.
 If you do not see this comment within an hour or two, you can follow the steps in this section of our guide:
 https://central.sonatype.org/publish/release/

这个是工作人员告诉我已经通过了，可以去下面那个地址发布(前两个地址)，发布后去下面后两个地址搜索。接下来可以后面的步骤了。

3.PGP

Windows 系统，可以下载 Gpg4win 软件来生成密钥对。下载地址：https://www.gpg4win.org/download.html

（1）查看是否安装成功

gpg --version

出现版本等信息说明安装成功了。

（2）生成密钥对

gpg --gen-key
 
  
Real name: zimmor
 Email address: [email protected]
 You selected this USER-ID:
 "zimmor [email protected]"
 
  
Change (N)ame, (E)mail, or (O)kay/(Q)uit? o

接下来，会让你输入用户名和邮箱，还有一个Passphase（输入两次），相当于密钥库密码，这个要记好，后面要用。

（3）查看公钥

C:\Users\zimmor>gpg --list-keys
 C:/Users/zimmor/AppData/Roaming/gnupg/pubring.kbx
 
  
 
  
pub rsa3072 2021-09-26 [SC] [expires: 2023-09-26]
 6xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxE
 uid [ultimate] zimmor [email protected]
 sub rsa3072 2021-09-26 [E] [expires: 2023-09-26]

这里的6xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxE就是公钥

（4）将公钥发布到PGP秘钥服务器

gpg --keyserver hkp://keyserver.ubuntu.com:11371 --send-keys 6xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxE

这里的6xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxE应该填你的公钥

4.修改maven的主配置文件setting.xml

找到maven的全局配置文件settings.xml，在里面找到 server节点，这个节点默认是注释掉的，增加如下配置：

 
 oss
 用户名
 密码
 
 

这里的 id 是要在 pom.xml 里面使用的，用户名和密码就是在 Sonatype 上面注册的用户名和密码。

5.修改项目的配置文件pom.xml文件

 ...
 orange
 project description
 
 
 
 The Apache Software License, Version 2.0
 http://www.apache.org/licenses/LICENSE-2.0.txt
 
 
 
 
 zimmor
 [email protected]
 
 
 
 scm:git:https://github.com/freakchick/orange.git
 scm:git:https://github.com/freakchick/orange
 git:https://github.com/freakchick/orange.git
 
 
  

 
 release
 
 
 
 
 org.apache.maven.plugins
 maven-source-plugin
 2.2.1
 
 
 package
 
 jar-no-fork
 
 
 
 
 
 
 org.apache.maven.plugins
 maven-javadoc-plugin
 2.9.1
 
 
 package
 
 jar
 
 
 
 
 
 
 org.apache.maven.plugins
 maven-gpg-plugin
 1.5
 
 
 verify
 
 sign
 
 
 
 
 
 
 
 
 oss
 https://oss.sonatype.org/content/repositories/snapshots/
 
 
 oss
 https://oss.sonatype.org/service/local/staging/deploy/maven2/
 
 
 
 
 
 oss
 
 true
 
 
 gpg4
 the_pass_phrase
 
 
 
 ...
 

6.向sonatype仓库发布自己的jar包

（1）上传到 OSS

mvn clean deploy -P release

使用此命令发布到oss上

（2）在 OSS 中发布构件

使用 Sonatype 账号登录 https://oss.sonatype.org/#stagingRepositories，可在 Staging Repositories 中查看刚才已上传的构件。

先点击close按钮，最后点击 Release 按钮来发布该构件。手动刷新后看到已经发布。

7.在maven中央仓库确认自己已发布的jar包

发布后官方给出的说明是半小时后jar包可以同步到https://repo1.maven.org/maven2/，4小时后可以同步到 https://search.maven.org

再强调下本次踩的几个坑

1. 新建issue中的groupId中，如果代码管理平台用的是GitHub，sonatype不支持GitHub的二级域名了，例如com.github.zimmor这种了，而是支持io.github.zimmor这种以io开头的域名，如果代码管理平台用的是国内的Gitee，sonatype是支持Gitee的二级域名的，例如com.gitee.zimmor。

2. maven主配置文件中定义的server的id和项目配置文件中snapshotRepository和repository的配置文件要保持一致。

3. 发布不成功，检查Issue 审批是否成功。

4. 本次坑中的MVP，如果发布到sonatype仓库时报401错误，发布失败，我看了官方的一些解决方案，尝试配置下pgp的版本，我用的是pgp4，配置后就可以发布了，这个地方卡了好长时间，是真的坑。。。就是下面这个配置，上面的pom.xml中也有。

 
     
         oss
         
             true
         
         
             gpg4
             the_pass_phrase