Java Signature 类实现数据签名与验签详解

本文深入剖析了Java中Signature类在数据签名与验签过程中的核心机制与典型陷阱，重点揭示了IllegalStateException频发的根本原因——Signature实例的强状态性及三步（initSign/update/sign）不可逆、不可复用的严格顺序；同时系统梳理了验签失败的四大元凶：算法名称不一致、摘要方式错配、原始数据字节级不统一以及密钥格式（如PKCS#8/X.509）或编码（如PEM解析时隐藏的\r\n、空格、Base64二次编码）处理不当，并给出安全加载密钥、规避手动哈希、选用现代算法等切实可行的生产级实践建议，帮助开发者避开静默失败的深坑，构建健壮可信的数字签名体系。

Signature 类签名时为什么总是抛出 IllegalStateException？

调用 sign() 前没执行 initSign(privateKey)，或执行过 update() 后又调用了 initSign()，都会触发这个异常。Signature 实例是**有状态的**，初始化、更新、生成签名三步必须严格按序，且不可复用同一实例做多次签名（除非重新 init）。

实操建议：

• 每次签名都新建 Signature 实例，避免状态污染
• 务必检查 privateKey 是否为 PKCS#8 编码的 PrivateKey，而非原始字节或 PEM 字符串
• 若从 PEM 文件读取私钥，需先用 Base64.getDecoder().decode() 解码，并跳过 -----BEGIN PRIVATE KEY----- 等头尾行

验签失败常见原因：算法、编码、数据一致性

验签失败不一定是密钥错了，更常因三处不匹配：签名算法名称、摘要方式、原始数据内容。例如用 SHA256withRSA 签名，验签时却传入 SHA256withECDSA，或签名前对明文做了 UTF-8 编码，验签时却用 ISO-8859-1 解码再 update，必然失败。

实操建议：

• 签名与验签两端必须使用完全相同的 getInstance() 参数，如 Signature.getInstance("SHA256withRSA")
• 验签前 update() 的数据，必须和签名前 update() 的**完全一致**（字节级相同）
• 如果报 SignatureException: Signature length not correct，说明传入的签名字节数与密钥长度不匹配（如 2048 位 RSA 签名应为 256 字节），检查是否被 Base64 二次编码或截断

如何安全地加载公私钥而不硬编码？

直接在代码里写 new String("MIIE...") 是高危操作。Java 不提供开箱即用的 PEM 解析器，得手动剥离头尾、Base64 解码，再交由 KeyFactory 转换。

实操建议：

• 私钥加载示例：

  String pem = Files.readString(Paths.get("key.pem")).replaceAll("-----(BEGIN|END).*?-----", "").replaceAll("\\s", "");
  byte[] encoded = Base64.getDecoder().decode(pem);
  PKCS8EncodedKeySpec spec = new PKCS8EncodedKeySpec(encoded);
  PrivateKey key = KeyFactory.getInstance("RSA").generatePrivate(spec);

• 公钥同理，但用 X509EncodedKeySpec 和 generatePublic()
• 生产环境建议用 Bouncy Castle 的 PEMParser，或统一走 JKS/PKCS#12 密钥库，避免手撕 PEM

验签时要不要对原始报文做哈希？

完全不需要。Signature 类内部已封装了摘要逻辑——比如 SHA256withRSA 表示“先用 SHA-256 摘要，再用 RSA 私钥加密摘要值”。你只需把原始报文（字节数组）传给 update()，它自动完成哈希+签名两步。手动先哈希再传摘要，反而会导致验签失败。

容易踩的坑：

• 误以为 Signature 只做加密，自己先调 MessageDigest.getInstance("SHA256").digest(data)，再把摘要喂给 update() → 错，这等于哈希了两次
• 用 sign() 返回的字节数组直接当“加密结果”存库，后续验签时却拿原始报文去比对 → 必须保存原始报文+签名字节数组，二者缺一不可
• 不同 JDK 版本对 SHA1withDSA 等老算法支持差异大，优先选 SHA256withRSA 或 SHA256withECDSA

验签逻辑本身简单，但密钥格式、编码方式、算法字符串拼写、数据字节一致性这四点，任一出错都会让整个流程静默失败。尤其要注意 PEM 解析时的换行和空格处理——肉眼看不见的 \r\n 就足以让 Base64 解码后多出几个非法字节。

今天关于《Java Signature 类实现数据签名与验签详解》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！