Goreleaser发布时报sign: gpg failed错误，本地签名命令正常如何解决

• 核心诱因是你的.goreleaser.yaml中signs.args参数存在语法错误：--local-user参数仅接收1个身份标识参数，你配置里同时传入${GPG_USER}和${GPG_FINGERPRINT}两个参数，会导致gpg命令解析失败。
• 环境变量未正确注入goreleaser运行环境：如果是CI环境运行goreleaser，可能GPG相关的环境变量没有正确导出；如果是本地运行，可能你没有提前设置GPG_USER、GPG_FINGERPRINT变量。
• GPG密钥权限问题：运行goreleaser的用户对GPG密钥环（~/.gnupg目录）没有读取权限，或者私钥没有被正确导入到当前运行用户的密钥环中。
• 二进制路径问题：goreleaser运行时无法找到gpg二进制文件，或者签名的目标文件路径和预期不符。

• 第一步：修正signs配置的参数，删除多余的入参。正确配置参考：

signs:
  - artifacts: checksum
    args:
      - "--batch"
      - "--local-user"
      - "${GPG_FINGERPRINT}" # 仅保留指纹/用户名其中一个作为--local-user的参数即可
      - "--output"
      - "${signature}"
      - "--detach-sign"
      - "${artifact}"

• 第二步：验证环境变量是否正确传递，运行goreleaser前执行echo $GPG_FINGERPRINT确认输出为正确的指纹值；如果是CI环境，需要确认GPG密钥已经提前导入到运行环境，且相关变量已经在CI配置中声明。
• 第三步：开启调试模式运行goreleaser，查看完整报错信息，执行命令：goreleaser release --debug，会打印出实际执行的gpg命令和完整报错日志，方便定位具体问题。
• 第四步：验证密钥权限，确保运行goreleaser的用户对~/.gnupg目录有读写权限，且需要用到的私钥已经正确导入，可执行gpg --list-secret-keys确认私钥存在。

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