4. 密钥不匹配排查：公钥与私钥不配对、使用了错误的密钥文件、密钥格式转换错误

密钥不匹配，是签名校验失败里最常见、也最让人头疼的问题。我遇到过不少开发同学，折腾了半天，最后发现是密钥文件拿错了——这种事，说实话我自己也干过。

这一节，咱们就把密钥不匹配的几种典型情况拆开来看。公钥私钥不配对、用错了密钥文件、格式转换出了岔子，一个一个过。

4.1 公钥与私钥不配对

签名校验的本质，是用私钥签名，用公钥验签。这两把钥匙必须是一对，就像锁和钥匙的关系。你拿A锁的钥匙去开B锁，肯定打不开。

为什么会不配对？常见原因有两个：

• 生成时就没配对：比如从不同渠道拿到的公钥和私钥，或者自己生成时操作失误。
• 中间被替换了：有人不小心覆盖了公钥文件，或者版本管理混乱，导致公钥和私钥不是同一批生成的。

我习惯在项目初始化时，就写一个简单的配对验证脚本。每次换密钥，先跑一遍，确认配对再往下走。这步省不了，真的。

4.1.1 如何验证配对

拿 OpenSSL 举例，验证 RSA 密钥配对很简单：

# 1. 从私钥提取公钥
openssl rsa -in private.pem -pubout -out extracted_pub.pem

# 2. 对比提取的公钥和你手里的公钥
diff extracted_pub.pem public.pem

# 如果输出为空，说明配对；否则不配对

嗯，这里要注意：diff 命令输出为空才表示一致。如果文件内容不同，哪怕只有一行不一样，那也是不配对。

openssl pkey -in private.pem -pubout -check

4.2 使用了错误的密钥文件

这个坑，我踩过不止一次。项目里密钥文件多了，环境也多了——开发环境、测试环境、生产环境，每个环境的密钥都不一样。一不小心，就把测试环境的私钥拿去签生产环境的包了。

你想想看，签名是成功了，但生产环境的公钥验签时，拿的是另一把公钥，结果自然是失败。

4.2.1 常见错误场景

我曾经在一个项目里，因为 CI/CD 脚本写错了路径，一直用的是备份目录里的旧密钥。排查了整整两天，最后发现是脚本里写死了路径，没跟着项目迁移。从那以后，我要求所有密钥路径必须从环境变量读取，绝不硬编码。

4.3 密钥格式转换错误

密钥格式这事儿，看着简单，但坑特别多。不同工具、不同平台，用的密钥格式可能不一样。最常见的就是 PEM、DER、PKCS#8、PKCS#1 这些格式之间的转换。

说白了，密钥文件就是一串二进制数据，但不同的格式规定了不同的包装方式。你拿 PKCS#1 格式的私钥，去给一个只认 PKCS#8 格式的工具用，那肯定报错。

4.3.1 常见格式对比

4.3.2 格式转换示例

我建议你记住这几个常用的转换命令，排查时能省不少时间：

# PEM 转 DER（私钥）
openssl rsa -in key.pem -outform DER -out key.der

# DER 转 PEM（私钥）
openssl rsa -in key.der -inform DER -out key.pem

# PKCS#1 转 PKCS#8（私钥）
openssl pkcs8 -topk8 -inform PEM -outform PEM -in rsa_private.pem -out pkcs8_private.pem -nocrypt

# PKCS#8 转 PKCS#1（私钥）
openssl rsa -in pkcs8_private.pem -out rsa_private.pem

4.3.3 格式错误的表现

格式不对，工具通常会直接报错。比如 OpenSSL 会提示 unable to load Private Key，或者 bad decrypt。但有时候，错误信息不那么明显，比如：

• Java 的 InvalidKeySpecException
• Python 的 ValueError: Could not deserialize key data
• Android 的 KeyStoreException: Invalid key format

遇到这些错误，先别急着怀疑算法或代码。检查一下密钥格式，八成是这里出了问题。

file private.pem
# 输出示例：private.pem: PEM RSA private key

4.4 密钥不匹配排查流程图

下面这张图，是我自己排查时用的思路。遇到签名校验失败，按这个流程走一遍，大部分问题都能定位到。

这张图的逻辑很简单：先确认配对，再检查文件，最后看格式。每一步都走通了，基本就能排除密钥不匹配的问题。