maven-central-publish 是一份面向 Java/Kotlin 库维护者的发布指南，基于 Sonatype Central Portal 整理 Maven Central 发布工作流。它通过标准化 Maven 配置模板串联账号准备、GPG 签名和部署步骤，适合需要建立或整理发布流程的开发者。
这份 Skill 是什么，适合解决哪些问题
这份 Skill 的主要内容是操作说明与配置模板，不是独立运行的发布程序。它将分散在账号、签名工具和项目配置中的准备事项汇集到同一条路径中，帮助维护者明确发布所需的条件及各环节之间的关系。
按提供的条目信息，它属于 CocoLoop Skill，安全等级标注为 S+，下载量为 720，并入选精选 Top 50。这些信息可作为了解条目的参考，但不能代替对具体配置和发布内容的检查。
适用人群包括首次发布 Java/Kotlin 开源库的开发者、准备迁移至 Central Portal 的维护者，以及希望复用 Maven 发布配置的团队。其覆盖范围集中在 Maven 生态，使用 Gradle 的项目仍需另行查阅对应说明。
功能覆盖：从发布材料到签名与部署
指南提供 Maven 插件配置模板，涉及源码包、Javadoc、GPG 签名和 Central Publishing 四类插件。它们分别处理发布附属材料、文档、签名及提交过程，使维护者能够按同一套配置思路组织项目的发布准备。
签名部分重点介绍 Loopback Pinentry 模式，用于处理无头环境中的签名交互问题。这对持续集成场景有帮助，但仍依赖正确的密钥、口令与执行环境配置，不能仅凭开启该模式就认定签名流程已经可用。
材料还列出了认证失败、GPG 签名错误和 Javadoc 生成失败等常见问题的排查方向。遇到部署失败时，可以据此区分凭证、签名或文档环节的问题，再检查对应配置。
使用路径：先完成账号与本地环境准备
使用前需要注册 Central Portal 账号，完成发布命名空间验证，并生成用户令牌。项目的 groupId 需要与已验证的命名空间对应，因此账号权限和项目坐标应在部署前核对，避免等到提交阶段才发现条件不满足。
本地环境需要准备 Maven、GPG 和 JDK 17 及以上版本，再按照指南设置签名方式。随后在 Maven 用户配置文件中填写 Central Portal 用户令牌，并在项目配置文件中加入所需插件。
配置完成后，按指南执行发布流程，并到 Portal 检查处理状态。该 Skill 不包含代替用户完成操作的自动化脚本，环境安装、模板调整和最终验证仍需维护者执行；首次使用时，应逐项确认模板与项目情况是否匹配。
自动发布与凭证管理需要怎样安排
指南区分手动确认和自动发布策略。关闭自动发布时，上传后仍需进入 Portal 界面确认；开启后则会省去这一步人工确认。团队应根据自己的版本检查流程选择方式，在发布前核对包内容、版本号和元数据。
用户令牌具有发布权限，GPG 私钥及其口令也需要妥善保管。指南建议使用用户令牌而非主账号密码，并通过持续集成系统的密钥管理或本地文件权限保护凭证，避免将敏感配置提交到版本控制。
Maven Central 不允许覆盖已发布版本，因此错误内容不能靠上传同版本文件来修正。网络中断也可能留下需要检查的处理状态，遇到异常应先查看 Portal 的部署结果，再决定后续操作。
使用限制：模板仍需维护，旧流程不能直接照搬
这份指南以新版 Central Portal 为目标，不兼容仍沿用旧版 OSSRH 的发布流程。旧项目迁移时，需要重新核对账号凭证、命名空间和插件配置，不能把替换模板视为迁移已经完成。
配置模板也存在版本敏感性。Central Publishing 插件的配置方式可能随迭代变化，采用指南时应核对项目使用的插件版本；来源材料中的版本信息不宜直接视为长期适用的配置依据。
维护者为个人账号，材料未提供企业级维护保障。对新手而言，密钥管理、多环境配置和命名空间验证仍有学习成本。这份 Skill 适合用作发布准备与排查的参考，实际部署仍需结合项目环境完成验证。
延伸阅读
© 版权声明
文章版权归作者所有，未经允许请勿转载。
