使用OpenPGP.js加载PGP私钥时报Misformed armored text错误如何解决

AI 小北

2026-10-6

排查解决步骤

Misformed armored text 错误本质是OpenPGP.js解析传入的 armored 格式内容时，检测到不符合格式规范的字符/结构，可按以下优先级排查：

清理私钥多余前导缩进
你当前代码中用模板字符串包裹的私钥每一行都带了多余的前导空格，模板字符串会完整保留这些缩进，而PGP armored格式要求密钥内容行不能有额外前导空格。调整时要保证从-----BEGIN PGP PRIVATE KEY BLOCK-----到-----END PGP PRIVATE KEY BLOCK-----的所有行，都和模板字符串开头对齐，删除多余的前置缩进。
排除复制粘贴引入的不可见字符/换行异常
手动从GnuPG输出复制私钥时，很容易带入零宽空格、错误的换行符（比如Windows CRLF转义异常、换行符被转成字面量\n）。可以先将私钥写入单独的.asc文件，用fs.readFileSync('私钥路径', 'utf8')读取内容传入，避免手动复制的格式问题。如果是从环境变量读取私钥，大部分部署平台会自动将换行转成字面量，需要额外做替换：
```
const priv_key = process.env.PGP_PRIV_KEY.replace(/\\n/g, '\n')
```
验证私钥本身合法性
首先确认你实际使用的私钥没有截断（不要出现示例中的省略内容），头尾标记完整无字符缺失/多余。可以本地用GnuPG直接导入私钥验证：gpg --import 你的私钥文件.asc，如果导入失败说明私钥本身已经损坏，需要重新导出。
适配版本兼容规则
如果你使用的是OpenPGP.js v5及以上版本，对armor格式的校验规则更严格，GnuPG 2.2.28默认导出的私钥可能带多余的扩展签名字段，导出时添加最小导出参数即可：
```
gpg --export-secret-keys --export-options export-minimal -a 你的密钥ID > priv.asc
```