PHP使用GNUPG解密文本时出现decrypt failed错误如何解决

首先你代码中存在一个明显的低级错误：putenv 定义的GNUPGHOME路径里多了一个*>*符号，会直接导致GPG找不到密钥环目录，第一步先删除这个多余符号，替换为你的真实密钥目录路径。

以下是完整的排查修复步骤：

1. 密钥目录权限与配置校验 #

• 修正后的GNUPGHOME路径需指向存放GPG密钥的真实.gnupg目录，确保运行PHP的进程（如web场景下的www-data用户）对该目录拥有700权限，目录内的私钥相关文件权限为600，GPG安全机制会拒绝访问权限不符合要求的密钥文件
• 确认解密用私钥已导入到对应目录的密钥环中，可切换到PHP运行用户后执行gpg --homedir 你的GNUPGHOME路径 --list-secret-keys验证
• 可执行php -m | grep gnupg验证gnupg扩展已正确安装，版本和系统GPG版本兼容

2. 解密密钥参数校验 #

• <FINGERPRINT>参数必须和私钥的指纹完全一致，可通过gpg --list-secret-keys --fingerprint查询，注意去掉查询结果中指纹的空格后再填入代码
• <PASSPHRASE>参数必须和私钥设置的密码完全匹配，若密码包含特殊字符需在PHP字符串中做好转义

3. 加密文本格式校验 #

• <ENCRYPTED_TEXT>必须包含完整的PGP加密报文头-----BEGIN PGP MESSAGE-----和报文尾-----END PGP MESSAGE-----，不要有多余的换行、空格、HTML转义字符，避免报文被破坏

4. 增加调试逻辑快速定位问题 #

替换为以下带调试的代码，提前输出密钥添加阶段的错误信息：

// 修正多余的>符号，替换为真实的密钥目录路径
putenv('GNUPGHOME=/home/USERNAME/.gnupg');
$payload = '<替换为完整的加密文本>';
$initGnupg = gnupg_init();
// 开启错误警告模式方便排查
gnupg_seterrormode($initGnupg, GNUPG_ERROR_WARNING);
// 校验密钥添加是否成功
$addKeyResult = gnupg_adddecryptkey($initGnupg, "<替换为正确的指纹>", "<替换为正确的私钥密码>");
if (!$addKeyResult) {
    echo "密钥添加错误：" . gnupg_geterror($initGnupg);
    exit;
}
$decryptedPayload = gnupg_decrypt($initGnupg, $payload);
echo "解密阶段错误：" . gnupg_geterror($initGnupg);
echo "<pre>";
print_r($decryptedPayload);

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