Java中数字签名核心是遵循非对称加密规范,选用SHA256withRSA等标准算法,正确加载PKCS#8私钥,对UTF-8编码的确定性字节报文调用update()和sign()生成DER签名,并确保验签端算法、密钥、数据字节完全一致。

在 Java 中使用 Signature 类对敏感业务报文进行数字签名,核心是遵循非对称加密规范(如 PKCS#1 v1.5 或 PSS),选用合适的算法(如 SHA256withRSA)、正确加载私钥,并确保签名与验签两端算法、填充、编码方式完全一致。关键不在“能不能签”,而在“签得是否标准、可互操作、抗篡改”。
选择符合国密或国际标准的签名算法
Java 的 Signature 支持多种标准组合,需根据合规要求和上下游系统兼容性选择:
-
国际通用(推荐):
SHA256withRSA(PKCS#1 v1.5 填充)、SHA256withRSA/PSS(更安全,需显式设置 PSS 参数) -
国密合规(如金融/政务场景):
SM3withSM2(需 Bouncy Castle 提供支持,JDK 原生不包含) - 避免使用已不安全的组合,如
MD5withRSA、SHA1withRSA
正确加载私钥并初始化 Signature 实例
私钥必须为标准格式(PKCS#8 PEM 或 DER),且不能被错误解码或截断。常见错误是把 Base64 编码的 PEM 私钥直接传入 KeyFactory 而未去除头尾标记和换行:
- 读取 PEM 私钥时,先提取中间 Base64 内容(去掉
-----BEGIN PRIVATE KEY-----等行) - 用
PKCS8EncodedKeySpec+KeyFactory.getInstance("RSA")解析 - 初始化
Signature时调用initSign(privateKey),不要漏掉这一步
对业务报文做确定性摘要再签名
敏感报文(如 JSON 字符串、XML 或二进制请求体)必须以**字节形式**输入,且需保证编码一致(如统一 UTF-8),否则相同逻辑在不同环境生成不同签名:
将后端 Java 接口文档转换为前端 TypeScript 类型定义(interface / type)。输入:飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出:包含请求参数与响应结果的 .md 文件,含完整 JSDoc 注释。触发关键词:Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。
- 推荐先将业务对象序列化为规范字符串(例如:按 key 字典序排序后拼接,避免字段顺序影响)
- 调用
signature.update(dataBytes),而非sign()直接传参(后者仅适用于小数据,且易忽略编码问题) - 最终用
signature.sign()输出字节数组——这是标准 ASN.1 DER 编码的签名值,不可直接转 String,应 Base64 编码后传输
配套验签逻辑必须严格对齐
签名若无法被对方验证,90% 是因为两端配置不一致。验签端必须:
- 使用同一算法名(如
SHA256withRSA)初始化Signature - 加载的是对应的公钥(X.509 格式 PEM,用
X509EncodedKeySpec解析) - 对**完全相同的原始字节**(含相同编码、相同序列化规则)调用
update(),再用verify(signatureBytes) - 特别注意:Base64 解码后的签名字节必须原样传入
verify(),不要额外 hex 或 utf8 转换
不复杂但容易忽略——签名不是加个密就完事,它是协议级约定,从算法、密钥格式、编码、序列化到传输表达,每层都必须咬合。写完记得用 OpenSSL 或在线工具交叉验证签名结果是否可被标准工具识别。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










