Maven执行verify阶段maven-gpg-plugin:1.5报Exit code: 1错误如何解决

以下是针对该报错的分步排查和修复方法：

1. 本地GPG环境校验 #

• 确认本地已安装GnuPG工具：命令行执行gpg --version，无输出则先安装对应系统的GnuPG安装包。
• 确认存在可用的GPG私钥：执行gpg --list-secret-keys，无返回结果则执行gpg --gen-key按引导生成密钥对。
• 配置密钥密码：在Maven全局settings.xml的<servers>节点下添加密码配置，避免每次手动输入：

<server>
  <id>gpg.passphrase</id>
  <passphrase>你设置的GPG密钥密码</passphrase>
</server>

• 若需要临时排查，可执行mvn verify -X输出详细调试日志，定位具体报错原因。

2. 升级插件适配新环境 #

你当前使用的1.5版本插件较为老旧，对GnuPG 2.x版本适配存在兼容性问题，建议升级到最新稳定版，修改插件版本即可：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-gpg-plugin</artifactId>
  <!-- 替换为当前最新稳定版，例如3.1.0 -->
  <version>3.1.0</version>
  <executions>
    <execution>
      <id>sign-artifacts</id>
      <phase>verify</phase>
      <goals>
        <goal>sign</goal>
      </goals>
    </execution>
  </executions>
</plugin>

3. 本地开发跳过签名 #

如果当前是本地调试场景，不需要将构件发布到公共仓库，可以直接跳过签名步骤：

• 临时跳过：执行Maven命令时添加参数-Dgpg.skip=true
• 永久跳过：在插件配置中添加skip参数：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-gpg-plugin</artifactId>
  <version>3.1.0</version>
  <configuration>
    <skip>true</skip>
  </configuration>
  <executions>
    <execution>
      <id>sign-artifacts</id>
      <phase>verify</phase>
      <goals>
        <goal>sign</goal>
      </goals>
    </execution>
  </executions>
</plugin>

4. 自定义GPG路径配置 #

如果你的GPG工具安装在非系统默认路径，需要在插件配置中指定可执行文件路径：

<configuration>
  <executable>你的GNU安装路径/bin/gpg</executable>
</configuration>

Windows系统注意路径分隔符使用正斜杠或者双反斜杠，避免转义错误。

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