Mill项目发布到Maven Central时遇到的GPG密钥问题解析

在使用Mill构建工具将Scala/Java项目发布到Maven Central仓库时，开发者可能会遇到GPG签名失败的问题。本文将以一个实际案例为基础，深入分析这类问题的成因和解决方案。

问题现象

当开发者执行./mill publishSonatypeCentral命令时，虽然日志显示GPG密钥已成功导入，但最终仍会报错"gpg: no default secret key: No secret key"和"gpg: signing failed: No secret key"。错误表明GPG工具无法找到有效的私钥来进行签名操作。

根本原因分析

经过排查，这类问题通常由以下几个原因导致：

1. 密钥过期：GPG密钥设置了有效期，当超过有效期后密钥将无法使用
2. 密钥环配置问题：GPG无法正确识别密钥环中的密钥
3. 环境变量配置不当：MILL_PGP_PASSPHRASE或MILL_PGP_SECRET_BASE64设置不正确

在本案例中，问题的根源在于GPG密钥已经过期。虽然该密钥之前在其他构建工具(如Gradle、Maven)中可以正常使用，但Mill对密钥有效性的检查更为严格。

解决方案

要解决这个问题，开发者需要采取以下步骤：

1. 检查密钥有效期：

   gpg --list-keys
   

   查看密钥的过期日期

2. 更新密钥有效期：

   gpg --edit-key [密钥ID]
   

   在交互界面中使用expire命令修改密钥有效期

3. 重新导出密钥：

   gpg --export-secret-keys [密钥ID] | base64 > secret.key
   

   获取新的BASE64编码的密钥字符串

4. 更新环境变量： 将新的密钥字符串和密码短语设置到环境变量中

最佳实践建议

1. 定期检查GPG密钥的有效期，避免在发布时才发现问题
2. 为CI/CD环境单独创建长期有效的发布密钥
3. 在本地测试GPG签名功能是否正常工作
4. 考虑使用密钥管理服务来安全地存储和轮换密钥

总结

Mill作为新一代构建工具，对发布流程有着严格的要求。开发者在迁移项目到Mill时，需要特别注意GPG密钥的有效性。通过本文的分析和解决方案，开发者可以快速定位和解决类似问题，确保项目能够顺利发布到Maven Central仓库。

对于使用Mill进行项目发布的新手，建议在正式发布前先在快照仓库进行测试，验证整个发布流程的各个环节是否配置正确。