Git提交时GPG签名失败：故障排查与修复方案问询

一、故障点排查步骤 #

• 检查Git的GPG相关配置
  执行以下命令查看是否开启提交签名及指定的密钥：

  git config --list | grep gpg
  

  重点确认commit.gpgsign是否为true，以及user.signingkey是否指向存在的密钥ID。

• 验证GPG密钥有效性
  列出本地私钥，检查密钥状态：

  gpg --list-secret-keys --keyid-format=long
  

  确认对应邮箱的私钥是否存在，以及密钥是否过期（过期密钥会标注expired）。

• 独立测试GPG签名功能
  执行详细签名测试，获取具体错误信息：

  echo "test content" | gpg --clearsign
  

  观察输出提示，密码错误、密钥损坏、代理异常等问题都会有明确反馈。

• 检查GPG代理状态
  Xubuntu依赖gpg-agent处理密钥交互，先检查代理运行状态：

  echo $GPG_AGENT_INFO
  

  若无输出，重启代理后重试：

  gpgconf --kill gpg-agent
  gpg-agent --daemon
  

二、问题修复方案 #

方案1：重置GPG密钥（保留签名功能） #

因原密钥密码遗忘，直接替换密钥：

1. 删除旧密钥
   从gpg --list-keys输出中提取旧密钥ID，依次删除私钥和公钥：

   gpg --delete-secret-keys [旧密钥ID]
   gpg --delete-keys [旧密钥ID]
   

2. 生成新GPG密钥
   执行交互式命令生成新密钥：

   gpg --full-generate-key
   

   • 密钥类型选择RSA
   • 密钥长度建议设为4096
   • 设置合理过期时间（如1年）
   • 填写关联邮箱、姓名，设置新密码并妥善记录
3. 配置Git使用新密钥
   从gpg --list-secret-keys --keyid-format=long的sec行提取新密钥ID（格式类似rsa4096/ABCDEFG123456789，后半段为密钥ID）：

   git config --global user.signingkey [新密钥ID]
   # 若之前未开启全局签名，执行以下命令开启
   git config --global commit.gpgsign true
   

4. （可选）同步公钥到代码托管平台
   导出公钥并复制到GitHub/GitLab等平台的GPG密钥设置中：

   gpg --armor --export [新密钥ID]
   

方案2：关闭Git提交签名（快速恢复提交） #

若无需提交签名，直接关闭该功能：

• 全局关闭（所有仓库生效）：

  git config --global commit.gpgsign false
  

• 仅当前仓库关闭：
  进入目标仓库目录后执行：

  git config commit.gpgsign false
  

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