GitHub Desktop GPG签名失败求助（两类报错及版本信息）

遇到的两类报错 #

第一类（keyboxd相关）

gpg: error running '/usr/lib/gnupg/keyboxd': probably not installed
gpg: failed to start keyboxd '/usr/lib/gnupg/keyboxd': Configuration error
gpg: can't connect to the keyboxd: Configuration error
gpg: error opening key DB: No Keybox daemon running
gpg: skipped "your key": Input/output error
gpg: signing failed: Input/output error
error: gpg failed to sign the data
fatal: failed to write commit object

第二类（密钥IO错误）

gpg: skipped "your key": Input/output error
gpg: signing failed: Input/output error
error: gpg failed to sign the data
fatal: failed to write commit object

针对性解决方案 #

解决第一类keyboxd报错

GPG 2.4+版本依赖keyboxd服务，报错说明该服务未安装或路径配置错误：

• 安装keyboxd：
  根据你的发行版执行对应命令：
  Debian/Ubuntu系：

  sudo apt install gnupg-keyboxd
  

  Fedora/RHEL系：

  sudo dnf install gnupg-keyboxd
  

• 确认keyboxd路径配置：
  先查找keyboxd实际位置：

  which keyboxd
  

  编辑~/.gnupg/gpg.conf文件，添加或修改以下内容（替换为实际路径）：

  keybox-program /usr/lib/gnupg/keyboxd
  

• 重启gpg-agent：

  gpgconf --kill gpg-agent
  

  关闭并重新打开GitHub Desktop。

解决第二类密钥IO报错

这类报错通常是Git与GPG密钥配置不匹配、gpg-agent未运行或权限问题导致：

• 配置Git使用正确的GPG密钥：
  先通过以下命令获取你的密钥ID：

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

  然后配置Git全局签名密钥：

  git config --global user.signingkey YOUR_GPG_KEY_ID
  git config --global commit.gpgsign true
  

• 确保gpg-agent处于运行状态：
  执行命令启动daemon：

  gpg-agent --daemon
  

• 测试GPG本地签名功能：
  执行以下命令验证GPG本身能否正常签名：

  echo "test" | gpg --clearsign
  

  如果这一步失败，优先排查GPG密钥本身的问题（比如密钥过期、密码错误）。
• 确保GitHub Desktop拥有足够权限：
  Linux下，尝试从终端启动GitHub Desktop，继承终端的环境变量和权限：

  github-desktop
  

  Windows下可尝试以管理员身份运行GitHub Desktop，或检查WSL环境下的文件权限。
• 重置gpg-agent缓存：

  gpgconf --kill gpg-agent
  

  清除缓存后重新尝试签名操作。

通用排查步骤 #

1. 确认GitHub Desktop使用系统Git：在GitHub Desktop设置的Git选项中，勾选「Use system Git」，避免内置Git的环境变量问题。
2. 配置正确的GPG_TTY环境变量：在终端执行export GPG_TTY=$(tty)，再从该终端启动GitHub Desktop，确保GPG能正确获取终端输入密码。

内容的提问来源于stack exchange，提问作者Eduardo Castro