Signature 抛 IllegalStateException 是因实例有状态且步骤不可逆：必须先 initSign，再 update，最后 sign；复用实例或顺序错均触发异常。

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

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

实操建议：

立即学习“Java免费学习笔记（深入）”；

Java Maven Common

Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。

下载

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

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

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

实操建议：

立即学习“Java免费学习笔记（深入）”；

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

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

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

实操建议：

立即学习“Java免费学习笔记（深入）”；

• 私钥加载示例：

  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 解析时的换行和空格处理——肉眼看不见的 就足以让 Base64 解码后多出几个非法字节。