1. 项目概述为什么Java开发者必须掌握加密算法在Java开发这条路上无论你是刚入行的新手还是摸爬滚打多年的老手迟早都会遇到一个绕不开的坎数据安全。我见过太多项目业务逻辑写得天花乱坠性能优化做得滴水不漏但一到数据传输、密码存储、接口签名这些环节要么是简单用个MD5了事要么是网上随便找个代码片段就往上怼。结果呢轻则数据被篡改重则系统被拖库安全事件一旦发生之前所有的努力都可能付诸东流。这个项目就是为你解决这个痛点而生的。它不是一个泛泛而谈的理论教程而是一份聚焦于Java常用加密算法的实战代码库。我会带你从最基础的哈希算法开始一路深入到对称加密、非对称加密最后到国密算法。每一部分都不仅仅是“详解”更会提供可直接复制、粘贴、运行的完整测试示例。你不需要再去各个论坛拼凑零散的代码也不用担心示例跑不通。我的目标很明确让你在读完这篇文章后手头就有一套经过验证的、能直接用在生产环境或面试中的加密工具代码并且真正理解每一种算法背后的“为什么”。从网络热搜词也能看出RSA、SM2、SM4、SSL弱加密算法等都是大家关注和面试常问的焦点。本文将覆盖这些核心内容并解释如何避免常见的加密陷阱。2. 加密算法核心分类与选型指南在动手写代码之前我们必须先建立起清晰的认知地图。加密算法不是铁板一块根据其核心特性和用途主要分为三大类。选错了类型就像用螺丝刀去钉钉子事倍功半不说还可能留下安全隐患。2.1 哈希算法摘要算法数据的“指纹”哈希算法的核心特点是单向、不可逆。你把任意长度的数据比如一个文件、一段密码丢进去它会输出一个固定长度的、看似乱码的字符串哈希值。这个过程你无法反向推导出原始数据。核心用途密码存储这是哈希算法最经典的应用。你绝对不应该在数据库里明文存储用户密码。正确的做法是用户注册时将其密码进行哈希运算只存储这个哈希值。用户登录时再将输入的密码进行同样的哈希运算对比两个哈希值是否一致。数据完整性校验下载一个大型安装包时官网通常会提供一个MD5或SHA-256的校验值。你下载后自己计算一遍文件的哈希值如果和官网提供的一致就说明文件在传输过程中没有被篡改。数字签名的一部分常与非对称加密结合使用。Java常用实现MessageDigest类。常见算法MD5输出128位16字节哈希值。注意由于其抗碰撞性已被攻破绝对不应用于任何安全场景仅可用于非关键的校验。SHA-1输出160位哈希值。同样存在安全隐患应避免在安全场景使用。SHA-256SHA-2家族成员输出256位哈希值。目前是安全场景的推荐标准广泛应用于密码存储、证书签名等。SHA-512输出512位哈希值更安全但计算稍慢存储占用也更大。实操心得在密码存储场景单纯使用SHA-256也是不够的。因为相同的密码会产生相同的哈希值攻击者可以通过“彩虹表”进行反向查询。必须引入“盐值”Salt来增加破解难度。2.2 对称加密算法同一把钥匙对称加密就像用一个带锁的盒子来传递秘密。加密和解密使用的是同一把密钥。发送方用密钥加密数据接收方用同一把密钥解密数据。核心特点加解密速度快适合加密大量数据如文件内容、HTTP请求体。核心挑战密钥分发与管理。如何安全地把密钥交给对方且不被第三方窃取是个难题。Java常用实现Cipher类指定算法如AES、DES。常见算法DES数据加密标准密钥长度56位。已不安全严禁使用。3DES三重DES作为DES的过渡方案。速度慢也逐渐被淘汰。AES高级加密标准是目前对称加密的绝对主流和首选。密钥长度支持128、192、256位。AES-256被用于保护最高机密信息其安全性得到广泛认可。2.3 非对称加密算法公钥与私钥的配对非对称加密使用一对 mathematically linked 的密钥公钥和私钥。公钥可以公开给任何人私钥必须严格保密。核心原理用公钥加密的数据只能用对应的私钥解密。用私钥签名的数据可以用对应的公钥验证签名来源和完整性。核心特点解决了对称加密的密钥分发问题因为公钥可以公开。但加解密速度非常慢比对称加密慢几个数量级。核心用途密钥交换在HTTPSTLS/SSL中通信双方先用非对称加密如RSA安全地协商出一个临时的对称加密密钥后续通信则用这个对称密钥进行高速加密。这就是著名的“混合加密”机制。数字签名验证消息发送者的身份和消息是否被篡改。加密少量关键数据如加密对称加密的密钥本身。Java常用实现KeyPairGenerator,Cipher(用于加解密),Signature(用于签名)。常见算法RSA最经典、应用最广泛的非对称算法。其安全性基于大数分解的难度。ECC椭圆曲线加密。在相同安全强度下比RSA所需的密钥长度短得多例如256位ECC ≈ 3072位RSA因此计算更快存储空间更小。在移动设备和资源受限环境中优势明显。SM2中国国家密码管理局发布的商用椭圆曲线公钥密码算法属于国密标准。在政务、金融等领域有强制或推荐使用要求。3. 核心细节解析与避坑要点了解了分类我们深入到每种算法的Java实现细节中。这里藏着无数新手容易踩进去的坑。3.1 哈希算法的“盐”与“迭代”前面提到存储密码不能直接用SHA-256。一个健壮的密码存储方案需要加盐为每个用户的密码生成一个随机字符串盐将盐与密码拼接后再进行哈希。这样即使两个用户密码相同由于盐不同最终的哈希值也不同彻底防御了彩虹表攻击。多次迭代将哈希过程重复多次例如10万次极大增加暴力破解的时间成本。这被称为“密钥延伸”。在Java中我们通常不自己手动实现这个过程而是使用现成的、经过严格安全审查的库比如BCrypt、SCrypt或PBKDF2。Spring Security中的PasswordEncoder就默认使用了BCrypt。一个常见的错误示例// 错误直接MD5且无盐 String hashedPassword DigestUtils.md5Hex(password); user.setPassword(hashedPassword); // 存入数据库正确的思路使用Spring Security BCryptBean public PasswordEncoder passwordEncoder() { return new BCryptPasswordEncoder(); } // 注册时 String encodedPassword passwordEncoder.encode(rawPassword); // 登录时 boolean matches passwordEncoder.matches(rawPassword, storedEncodedPassword);BCrypt会自动处理盐的生成和存储盐通常直接包含在生成的哈希字符串中并采用自适应成本因子来控制迭代次数。3.2 对称加密的模式与填充使用AES时仅仅指定“AES”是不够的你必须明确指定加密模式和填充方案。这是一个极易出错的地方。加密模式定义了如何重复应用算法来加密比一个块更长的数据。ECB电子密码本模式。相同的明文块加密成相同的密文块。极其不安全会暴露明文的数据模式。绝对不要使用。CBC密码分组链接模式。每个明文块先与前一个密文块进行异或操作后再加密。需要一个初始化向量。这是目前最常用的模式之一。GCM伽罗瓦/计数器模式。这是一种认证加密模式不仅能提供保密性还能提供完整性校验。是现代TLS协议和许多新系统的推荐模式但Java 8及以下版本需要额外的JCE支持包。填充方案因为AES是块加密数据长度必须是块大小的整数倍AES块大小为128位即16字节。填充用于处理最后一块长度不足的情况。PKCS5Padding/PKCS7Padding最常用的填充方案。在Java中你必须完整指定算法/模式/填充// 正确指定算法、模式、填充 Cipher cipher Cipher.getInstance(AES/CBC/PKCS5Padding); // 错误只指定算法会使用提供商默认的模式和填充可能导致跨平台不一致或安全问题。 // Cipher cipher Cipher.getInstance(AES);初始化向量CBC模式需要一个随机的、不可预测的IV且每次加密都应不同。IV不需要保密可以随密文一起传输。但绝对不能重复使用同一个密钥和IV进行加密否则会严重削弱安全性。3.3 非对称加密的密钥长度与格式对于RSA密钥长度直接关系到安全性。1024位的RSA密钥已被认为不安全。目前的最低要求是2048位对于需要长期安全的数据建议使用3072位或4096位。生成密钥对时需要指定长度KeyPairGenerator keyGen KeyPairGenerator.getInstance(RSA); keyGen.initialize(2048); // 指定密钥长度 KeyPair keyPair keyGen.generateKeyPair();另一个坑是密钥的格式。生成的PublicKey和PrivateKey对象是二进制的通常我们需要将其转换为字符串进行存储或传输。常见格式有PKCS#8私钥的通用格式。X.509公钥的通用格式。PEM一种基于Base64编码的文本格式便于阅读和传输通常在前后加上-----BEGIN XXX-----和-----END XXX-----的标签。在Java中可以使用Base64编码将密钥的字节数组转换为字符串。// 将公钥转换为Base64字符串 String publicKeyStr Base64.getEncoder().encodeToString(keyPair.getPublic().getEncoded()); // 还原公钥 byte[] publicKeyBytes Base64.getDecoder().decode(publicKeyStr); KeyFactory keyFactory KeyFactory.getInstance(RSA); PublicKey publicKey keyFactory.generatePublic(new X509EncodedKeySpec(publicKeyBytes));4. 实战代码与可直接运行的测试示例理论说再多不如一行代码。下面我将提供关键算法的完整、可运行的Java示例。你可以直接创建一个Java类将代码复制进去运行。4.1 哈希算法实战SHA-256 with Salt我们手动实现一个加盐的SHA-256以理解其原理但在生产环境中仍建议使用BCrypt等专业库。import java.security.MessageDigest; import java.security.SecureRandom; import java.util.Base64; public class HashExample { /** * 生成随机的盐值 * param length 盐值字节长度 * return Base64编码的盐值字符串 */ public static String generateSalt(int length) { SecureRandom random new SecureRandom(); byte[] salt new byte[length]; random.nextBytes(salt); return Base64.getEncoder().encodeToString(salt); } /** * 使用SHA-256和盐值对密码进行哈希 * param password 明文密码 * param salt Base64编码的盐值 * return 十六进制格式的哈希值 */ public static String hashWithSalt(String password, String salt) throws Exception { MessageDigest md MessageDigest.getInstance(SHA-256); // 将盐值解码回字节数组 byte[] saltBytes Base64.getDecoder().decode(salt); // 先更新盐值 md.update(saltBytes); // 再更新密码 byte[] hashedBytes md.digest(password.getBytes(UTF-8)); // 将字节数组转换为十六进制字符串 StringBuilder sb new StringBuilder(); for (byte b : hashedBytes) { sb.append(String.format(%02x, b)); } return sb.toString(); } /** * 验证密码 * param password 待验证的明文密码 * param salt 存储的盐值 * param expectedHash 存储的哈希值 * return 验证是否通过 */ public static boolean verifyPassword(String password, String salt, String expectedHash) throws Exception { String actualHash hashWithSalt(password, salt); // 使用恒定时间比较避免计时攻击简化示例实际可用MessageDigest.isEqual return actualHash.equals(expectedHash); } public static void main(String[] args) throws Exception { String rawPassword MySuperSecretPassword123!; // 1. 生成并存储盐值 String salt generateSalt(16); System.out.println(生成的盐值 (Base64): salt); // 2. 计算并存储哈希值 String storedHash hashWithSalt(rawPassword, salt); System.out.println(存储的密码哈希: storedHash); // 3. 模拟登录验证 String inputPassword MySuperSecretPassword123!; boolean isCorrect verifyPassword(inputPassword, salt, storedHash); System.out.println(密码验证结果: (isCorrect ? 成功 : 失败)); // 4. 测试错误密码 String wrongPassword WrongPassword; isCorrect verifyPassword(wrongPassword, salt, storedHash); System.out.println(错误密码验证结果: (isCorrect ? 成功 (异常!) : 失败 (正常))); } }运行说明直接运行main方法你会看到盐值、哈希值的生成以及正确和错误密码的验证过程。4.2 对称加密实战AES/CBC/PKCS5Padding这是一个完整的AES加密解密示例包含了IV的处理。import javax.crypto.Cipher; import javax.crypto.KeyGenerator; import javax.crypto.SecretKey; import javax.crypto.spec.IvParameterSpec; import java.security.SecureRandom; import java.util.Base64; public class AesExample { public static final String ALGORITHM AES; public static final String TRANSFORMATION AES/CBC/PKCS5Padding; public static final int KEY_SIZE 128; // 也可以是 192 或 256但可能需要安装JCE无限制策略文件 /** * 生成AES密钥 */ public static SecretKey generateKey() throws Exception { KeyGenerator keyGen KeyGenerator.getInstance(ALGORITHM); keyGen.init(KEY_SIZE, new SecureRandom()); return keyGen.generateKey(); } /** * 生成随机的初始化向量 (IV) */ public static byte[] generateIv() { byte[] iv new byte[16]; // AES块大小是16字节 new SecureRandom().nextBytes(iv); return iv; } /** * 加密 * param plainText 明文 * param key 密钥 * param iv 初始化向量 * return Base64编码的密文 */ public static String encrypt(String plainText, SecretKey key, byte[] iv) throws Exception { Cipher cipher Cipher.getInstance(TRANSFORMATION); IvParameterSpec ivSpec new IvParameterSpec(iv); cipher.init(Cipher.ENCRYPT_MODE, key, ivSpec); byte[] encryptedBytes cipher.doFinal(plainText.getBytes(UTF-8)); return Base64.getEncoder().encodeToString(encryptedBytes); } /** * 解密 * param cipherText Base64编码的密文 * param key 密钥 * param iv 加密时使用的IV * return 明文 */ public static String decrypt(String cipherText, SecretKey key, byte[] iv) throws Exception { Cipher cipher Cipher.getInstance(TRANSFORMATION); IvParameterSpec ivSpec new IvParameterSpec(iv); cipher.init(Cipher.DECRYPT_MODE, key, ivSpec); byte[] decodedBytes Base64.getDecoder().decode(cipherText); byte[] decryptedBytes cipher.doFinal(decodedBytes); return new String(decryptedBytes, UTF-8); } public static void main(String[] args) throws Exception { String originalText 这是一段需要加密的敏感数据比如订单号202405200001; // 1. 生成密钥 (在实际应用中密钥需要安全存储不能每次生成) SecretKey secretKey generateKey(); System.out.println(AES密钥 (Base64): Base64.getEncoder().encodeToString(secretKey.getEncoded())); // 2. 生成IV (每次加密都必须使用新的随机IV) byte[] iv generateIv(); System.out.println(IV (Base64): Base64.getEncoder().encodeToString(iv)); // 3. 加密 String encryptedText encrypt(originalText, secretKey, iv); System.out.println(加密后的密文: encryptedText); // 4. 解密 String decryptedText decrypt(encryptedText, secretKey, iv); System.out.println(解密后的明文: decryptedText); // 5. 验证 System.out.println(原文与解密文是否一致: originalText.equals(decryptedText)); } }关键点注意TRANSFORMATION的完整定义以及IvParameterSpec的使用。IV需要和密文一起存储或传输给解密方。4.3 非对称加密实战RSA加密与签名这个示例展示了RSA的两种主要用途加密解密和数字签名/验证。import javax.crypto.Cipher; import java.security.*; import java.util.Base64; public class RsaExample { public static final String ALGORITHM RSA; public static final int KEY_SIZE 2048; /** * 生成RSA密钥对 */ public static KeyPair generateKeyPair() throws Exception { KeyPairGenerator keyPairGen KeyPairGenerator.getInstance(ALGORITHM); keyPairGen.initialize(KEY_SIZE, new SecureRandom()); return keyPairGen.generateKeyPair(); } /** * RSA加密 (使用公钥) * 注意RSA有长度限制加密的数据不能超过 (密钥长度/8 - 11) 字节 */ public static String encrypt(String plainText, PublicKey publicKey) throws Exception { Cipher cipher Cipher.getInstance(ALGORITHM); cipher.init(Cipher.ENCRYPT_MODE, publicKey); byte[] encryptedBytes cipher.doFinal(plainText.getBytes(UTF-8)); return Base64.getEncoder().encodeToString(encryptedBytes); } /** * RSA解密 (使用私钥) */ public static String decrypt(String cipherText, PrivateKey privateKey) throws Exception { Cipher cipher Cipher.getInstance(ALGORITHM); cipher.init(Cipher.DECRYPT_MODE, privateKey); byte[] decodedBytes Base64.getDecoder().decode(cipherText); byte[] decryptedBytes cipher.doFinal(decodedBytes); return new String(decryptedBytes, UTF-8); } /** * 使用私钥对数据进行签名 */ public static String sign(String data, PrivateKey privateKey) throws Exception { Signature signature Signature.getInstance(SHA256withRSA); signature.initSign(privateKey); signature.update(data.getBytes(UTF-8)); byte[] signBytes signature.sign(); return Base64.getEncoder().encodeToString(signBytes); } /** * 使用公钥验证签名 */ public static boolean verify(String data, String sign, PublicKey publicKey) throws Exception { Signature signature Signature.getInstance(SHA256withRSA); signature.initVerify(publicKey); signature.update(data.getBytes(UTF-8)); byte[] signBytes Base64.getDecoder().decode(sign); return signature.verify(signBytes); } public static void main(String[] args) throws Exception { String originalData 这是一段需要加密或签名的数据。RSA加密数据长度有限; // 1. 生成密钥对 KeyPair keyPair generateKeyPair(); PublicKey publicKey keyPair.getPublic(); PrivateKey privateKey keyPair.getPrivate(); System.out.println( RSA 加密解密演示 ); // 2. 加密 (公钥加密) String encryptedData encrypt(originalData, publicKey); System.out.println(加密后的数据: encryptedData); // 3. 解密 (私钥解密) String decryptedData decrypt(encryptedData, privateKey); System.out.println(解密后的数据: decryptedData); System.out.println(加解密验证: originalData.equals(decryptedData)); System.out.println(\n RSA 数字签名演示 ); // 4. 签名 (私钥签名) String signature sign(originalData, privateKey); System.out.println(生成的签名: signature); // 5. 验签 (公钥验签) boolean isValid verify(originalData, signature, publicKey); System.out.println(签名验证结果: (isValid ? 有效 : 无效)); // 6. 测试篡改数据后的验签 String tamperedData originalData 被篡改了; boolean isTamperedValid verify(tamperedData, signature, publicKey); System.out.println(数据篡改后签名验证结果: (isTamperedValid ? 有效 (异常!) : 无效 (正常))); } }重要提示RSA加密有明文长度限制。对于更长的数据标准做法是用RSA加密一个随机生成的对称密钥如AES密钥然后用这个对称密钥去加密实际数据。这就是“混合加密”。4.4 国密算法实战SM4加密解密国密算法在特定领域是必选项。这里以SM4对称加密为例。由于Java标准库不包含国密算法我们需要使用BouncyCastle提供商。首先添加BouncyCastle依赖Mavendependency groupIdorg.bouncycastle/groupId artifactIdbcprov-jdk15to18/artifactId version1.74/version !-- 使用最新版本 -- /dependency然后编写SM4示例代码import org.bouncycastle.jce.provider.BouncyCastleProvider; import javax.crypto.Cipher; import javax.crypto.KeyGenerator; import javax.crypto.SecretKey; import javax.crypto.spec.IvParameterSpec; import javax.crypto.spec.SecretKeySpec; import java.security.Security; import java.util.Base64; public class Sm4Example { static { // 在静态块中注册BouncyCastle提供商 Security.addProvider(new BouncyCastleProvider()); } public static final String ALGORITHM SM4; public static final String TRANSFORMATION SM4/CBC/PKCS5Padding; public static final int KEY_SIZE 128; // SM4密钥固定为128位 /** * 生成SM4密钥 */ public static SecretKey generateKey() throws Exception { KeyGenerator keyGen KeyGenerator.getInstance(ALGORITHM, BC); keyGen.init(KEY_SIZE); return keyGen.generateKey(); } /** * 加密 */ public static String encrypt(String plainText, SecretKey key, byte[] iv) throws Exception { Cipher cipher Cipher.getInstance(TRANSFORMATION, BC); IvParameterSpec ivSpec new IvParameterSpec(iv); cipher.init(Cipher.ENCRYPT_MODE, key, ivSpec); byte[] encryptedBytes cipher.doFinal(plainText.getBytes(UTF-8)); return Base64.getEncoder().encodeToString(encryptedBytes); } /** * 解密 */ public static String decrypt(String cipherText, SecretKey key, byte[] iv) throws Exception { Cipher cipher Cipher.getInstance(TRANSFORMATION, BC); IvParameterSpec ivSpec new IvParameterSpec(iv); cipher.init(Cipher.DECRYPT_MODE, key, ivSpec); byte[] decodedBytes Base64.getDecoder().decode(cipherText); byte[] decryptedBytes cipher.doFinal(decodedBytes); return new String(decryptedBytes, UTF-8); } public static void main(String[] args) throws Exception { String originalText 这是一段使用国密SM4加密的测试数据。; // 1. 生成密钥 SecretKey secretKey generateKey(); System.out.println(SM4密钥 (Base64): Base64.getEncoder().encodeToString(secretKey.getEncoded())); // 2. 生成IV (CBC模式需要) byte[] iv new byte[16]; // SM4块大小也是16字节 java.security.SecureRandom.getInstanceStrong().nextBytes(iv); System.out.println(IV (Base64): Base64.getEncoder().encodeToString(iv)); // 3. 加密 String encryptedText encrypt(originalText, secretKey, iv); System.out.println(SM4加密后的密文: encryptedText); // 4. 解密 String decryptedText decrypt(encryptedText, secretKey, iv); System.out.println(SM4解密后的明文: decryptedText); // 5. 验证 System.out.println(原文与解密文是否一致: originalText.equals(decryptedText)); } }5. 常见问题与排查技巧实录在实际开发和调试中你会遇到各种各样的问题。下面是我总结的一些高频问题和解决方法。5.1 异常与错误排查速查表异常信息可能原因解决方案NoSuchAlgorithmException1. 算法名称拼写错误。2. 未安装相应的JCE提供者如国密算法。1. 检查算法字符串如AES/CBC/PKCS5Padding。2. 添加对应的Jar包如BouncyCastle并注册Security.addProvider()。InvalidKeyException1. 密钥长度不符合算法要求。2. 密钥类型错误如用RSA公钥做AES解密。3. 密钥已损坏或格式不正确。1. 确认密钥长度如AES-128/192/256。2. 检查加解密使用的密钥是否配对公钥加密私钥解。3. 检查密钥生成、存储、加载过程。BadPaddingException1. 解密时使用的密钥与加密时不一致。2. 加密模式或填充方案不匹配。3. 密文在传输过程中被损坏或篡改。1.最常见原因确保加解密使用同一个密钥。2. 确保Cipher.getInstance()的算法字符串完全一致。3. 检查Base64编解码过程或网络传输是否完整。IllegalBlockSizeException1. RSA加密的明文长度超限。2. 使用CBC等模式时未正确设置IV或IV错误。1. RSA加密前检查明文长度 ≤ (密钥长度/8 - 11)。对于长数据改用“混合加密”。2. 确保解密时使用的IV与加密时相同。AEADBadTagException(GCM模式)密文或附加认证数据(AAD)在传输中被篡改。GCM模式提供了完整性校验。此异常表明数据已被破坏应拒绝处理。检查数据传输的完整性。5.2 性能优化与最佳实践密钥管理是核心对称密钥绝不能硬编码在代码中。应使用安全的密钥管理系统如HashiCorp Vault、AWS KMS或从安全的配置中心获取。非对称密钥对私钥必须存放在受保护的位置如硬件安全模块HSM、操作系统密钥库。公钥可以公开。算法与参数选择弃用弱算法坚决不使用DES、MD5、SHA-1、RSA-1024以及ECB模式。使用强随机数密钥、盐值、IV的生成必须使用密码学安全的随机数生成器SecureRandom而不是Random或Math.random()。TLS/SSL连接在配置HTTPS服务器时禁用已知的弱加密套件如搜索词中提到的SSL弱加密算法只启用强算法套件如TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384。数据长度处理对于对称加密AES如果数据不是块大小的整数倍需要填充。PKCS5Padding是通用选择。对于非对称加密RSA只能加密很短的数据。长数据务必采用“混合加密”生成一个随机的对称密钥会话密钥用RSA公钥加密它然后用这个对称密钥加密实际数据。将加密后的会话密钥和加密后的数据一起发送。版本兼容性Java默认的JCE策略文件可能限制密钥长度如AES-256。如果需要使用无限制强度加密策略需从Oracle官网下载并替换JRE_HOME/lib/security/下的策略文件。使用国密等非标准算法时明确指定提供商如BC并确保运行环境中有对应的Jar包。5.3 调试与验证技巧从简单开始验证先用固定的、简单的明文如Hello, World!、密钥和IV进行加密解密确保基础流程正确。再逐步替换为随机生成的值。打印关键中间值在调试时可以将生成的密钥、IV、加密前后的字节数组用Base64或Hex打印都输出到日志中对比加解密前后是否一致。跨语言/平台交互如果你的Java后端需要和前端JavaScript或其他语言如Python进行加解密交互务必确认双方使用的算法、模式、填充、密钥格式、IV处理方式、字符编码完全一致。一个字节的差异都会导致失败。通常明确指定所有参数并做好文档是关键。单元测试为你的加密工具类编写完善的单元测试覆盖正常流程、错误密码、错误密钥、空数据等边界情况。
Java加密算法实战：从哈希、AES到RSA与国密SM4的完整代码指南
1. 项目概述为什么Java开发者必须掌握加密算法在Java开发这条路上无论你是刚入行的新手还是摸爬滚打多年的老手迟早都会遇到一个绕不开的坎数据安全。我见过太多项目业务逻辑写得天花乱坠性能优化做得滴水不漏但一到数据传输、密码存储、接口签名这些环节要么是简单用个MD5了事要么是网上随便找个代码片段就往上怼。结果呢轻则数据被篡改重则系统被拖库安全事件一旦发生之前所有的努力都可能付诸东流。这个项目就是为你解决这个痛点而生的。它不是一个泛泛而谈的理论教程而是一份聚焦于Java常用加密算法的实战代码库。我会带你从最基础的哈希算法开始一路深入到对称加密、非对称加密最后到国密算法。每一部分都不仅仅是“详解”更会提供可直接复制、粘贴、运行的完整测试示例。你不需要再去各个论坛拼凑零散的代码也不用担心示例跑不通。我的目标很明确让你在读完这篇文章后手头就有一套经过验证的、能直接用在生产环境或面试中的加密工具代码并且真正理解每一种算法背后的“为什么”。从网络热搜词也能看出RSA、SM2、SM4、SSL弱加密算法等都是大家关注和面试常问的焦点。本文将覆盖这些核心内容并解释如何避免常见的加密陷阱。2. 加密算法核心分类与选型指南在动手写代码之前我们必须先建立起清晰的认知地图。加密算法不是铁板一块根据其核心特性和用途主要分为三大类。选错了类型就像用螺丝刀去钉钉子事倍功半不说还可能留下安全隐患。2.1 哈希算法摘要算法数据的“指纹”哈希算法的核心特点是单向、不可逆。你把任意长度的数据比如一个文件、一段密码丢进去它会输出一个固定长度的、看似乱码的字符串哈希值。这个过程你无法反向推导出原始数据。核心用途密码存储这是哈希算法最经典的应用。你绝对不应该在数据库里明文存储用户密码。正确的做法是用户注册时将其密码进行哈希运算只存储这个哈希值。用户登录时再将输入的密码进行同样的哈希运算对比两个哈希值是否一致。数据完整性校验下载一个大型安装包时官网通常会提供一个MD5或SHA-256的校验值。你下载后自己计算一遍文件的哈希值如果和官网提供的一致就说明文件在传输过程中没有被篡改。数字签名的一部分常与非对称加密结合使用。Java常用实现MessageDigest类。常见算法MD5输出128位16字节哈希值。注意由于其抗碰撞性已被攻破绝对不应用于任何安全场景仅可用于非关键的校验。SHA-1输出160位哈希值。同样存在安全隐患应避免在安全场景使用。SHA-256SHA-2家族成员输出256位哈希值。目前是安全场景的推荐标准广泛应用于密码存储、证书签名等。SHA-512输出512位哈希值更安全但计算稍慢存储占用也更大。实操心得在密码存储场景单纯使用SHA-256也是不够的。因为相同的密码会产生相同的哈希值攻击者可以通过“彩虹表”进行反向查询。必须引入“盐值”Salt来增加破解难度。2.2 对称加密算法同一把钥匙对称加密就像用一个带锁的盒子来传递秘密。加密和解密使用的是同一把密钥。发送方用密钥加密数据接收方用同一把密钥解密数据。核心特点加解密速度快适合加密大量数据如文件内容、HTTP请求体。核心挑战密钥分发与管理。如何安全地把密钥交给对方且不被第三方窃取是个难题。Java常用实现Cipher类指定算法如AES、DES。常见算法DES数据加密标准密钥长度56位。已不安全严禁使用。3DES三重DES作为DES的过渡方案。速度慢也逐渐被淘汰。AES高级加密标准是目前对称加密的绝对主流和首选。密钥长度支持128、192、256位。AES-256被用于保护最高机密信息其安全性得到广泛认可。2.3 非对称加密算法公钥与私钥的配对非对称加密使用一对 mathematically linked 的密钥公钥和私钥。公钥可以公开给任何人私钥必须严格保密。核心原理用公钥加密的数据只能用对应的私钥解密。用私钥签名的数据可以用对应的公钥验证签名来源和完整性。核心特点解决了对称加密的密钥分发问题因为公钥可以公开。但加解密速度非常慢比对称加密慢几个数量级。核心用途密钥交换在HTTPSTLS/SSL中通信双方先用非对称加密如RSA安全地协商出一个临时的对称加密密钥后续通信则用这个对称密钥进行高速加密。这就是著名的“混合加密”机制。数字签名验证消息发送者的身份和消息是否被篡改。加密少量关键数据如加密对称加密的密钥本身。Java常用实现KeyPairGenerator,Cipher(用于加解密),Signature(用于签名)。常见算法RSA最经典、应用最广泛的非对称算法。其安全性基于大数分解的难度。ECC椭圆曲线加密。在相同安全强度下比RSA所需的密钥长度短得多例如256位ECC ≈ 3072位RSA因此计算更快存储空间更小。在移动设备和资源受限环境中优势明显。SM2中国国家密码管理局发布的商用椭圆曲线公钥密码算法属于国密标准。在政务、金融等领域有强制或推荐使用要求。3. 核心细节解析与避坑要点了解了分类我们深入到每种算法的Java实现细节中。这里藏着无数新手容易踩进去的坑。3.1 哈希算法的“盐”与“迭代”前面提到存储密码不能直接用SHA-256。一个健壮的密码存储方案需要加盐为每个用户的密码生成一个随机字符串盐将盐与密码拼接后再进行哈希。这样即使两个用户密码相同由于盐不同最终的哈希值也不同彻底防御了彩虹表攻击。多次迭代将哈希过程重复多次例如10万次极大增加暴力破解的时间成本。这被称为“密钥延伸”。在Java中我们通常不自己手动实现这个过程而是使用现成的、经过严格安全审查的库比如BCrypt、SCrypt或PBKDF2。Spring Security中的PasswordEncoder就默认使用了BCrypt。一个常见的错误示例// 错误直接MD5且无盐 String hashedPassword DigestUtils.md5Hex(password); user.setPassword(hashedPassword); // 存入数据库正确的思路使用Spring Security BCryptBean public PasswordEncoder passwordEncoder() { return new BCryptPasswordEncoder(); } // 注册时 String encodedPassword passwordEncoder.encode(rawPassword); // 登录时 boolean matches passwordEncoder.matches(rawPassword, storedEncodedPassword);BCrypt会自动处理盐的生成和存储盐通常直接包含在生成的哈希字符串中并采用自适应成本因子来控制迭代次数。3.2 对称加密的模式与填充使用AES时仅仅指定“AES”是不够的你必须明确指定加密模式和填充方案。这是一个极易出错的地方。加密模式定义了如何重复应用算法来加密比一个块更长的数据。ECB电子密码本模式。相同的明文块加密成相同的密文块。极其不安全会暴露明文的数据模式。绝对不要使用。CBC密码分组链接模式。每个明文块先与前一个密文块进行异或操作后再加密。需要一个初始化向量。这是目前最常用的模式之一。GCM伽罗瓦/计数器模式。这是一种认证加密模式不仅能提供保密性还能提供完整性校验。是现代TLS协议和许多新系统的推荐模式但Java 8及以下版本需要额外的JCE支持包。填充方案因为AES是块加密数据长度必须是块大小的整数倍AES块大小为128位即16字节。填充用于处理最后一块长度不足的情况。PKCS5Padding/PKCS7Padding最常用的填充方案。在Java中你必须完整指定算法/模式/填充// 正确指定算法、模式、填充 Cipher cipher Cipher.getInstance(AES/CBC/PKCS5Padding); // 错误只指定算法会使用提供商默认的模式和填充可能导致跨平台不一致或安全问题。 // Cipher cipher Cipher.getInstance(AES);初始化向量CBC模式需要一个随机的、不可预测的IV且每次加密都应不同。IV不需要保密可以随密文一起传输。但绝对不能重复使用同一个密钥和IV进行加密否则会严重削弱安全性。3.3 非对称加密的密钥长度与格式对于RSA密钥长度直接关系到安全性。1024位的RSA密钥已被认为不安全。目前的最低要求是2048位对于需要长期安全的数据建议使用3072位或4096位。生成密钥对时需要指定长度KeyPairGenerator keyGen KeyPairGenerator.getInstance(RSA); keyGen.initialize(2048); // 指定密钥长度 KeyPair keyPair keyGen.generateKeyPair();另一个坑是密钥的格式。生成的PublicKey和PrivateKey对象是二进制的通常我们需要将其转换为字符串进行存储或传输。常见格式有PKCS#8私钥的通用格式。X.509公钥的通用格式。PEM一种基于Base64编码的文本格式便于阅读和传输通常在前后加上-----BEGIN XXX-----和-----END XXX-----的标签。在Java中可以使用Base64编码将密钥的字节数组转换为字符串。// 将公钥转换为Base64字符串 String publicKeyStr Base64.getEncoder().encodeToString(keyPair.getPublic().getEncoded()); // 还原公钥 byte[] publicKeyBytes Base64.getDecoder().decode(publicKeyStr); KeyFactory keyFactory KeyFactory.getInstance(RSA); PublicKey publicKey keyFactory.generatePublic(new X509EncodedKeySpec(publicKeyBytes));4. 实战代码与可直接运行的测试示例理论说再多不如一行代码。下面我将提供关键算法的完整、可运行的Java示例。你可以直接创建一个Java类将代码复制进去运行。4.1 哈希算法实战SHA-256 with Salt我们手动实现一个加盐的SHA-256以理解其原理但在生产环境中仍建议使用BCrypt等专业库。import java.security.MessageDigest; import java.security.SecureRandom; import java.util.Base64; public class HashExample { /** * 生成随机的盐值 * param length 盐值字节长度 * return Base64编码的盐值字符串 */ public static String generateSalt(int length) { SecureRandom random new SecureRandom(); byte[] salt new byte[length]; random.nextBytes(salt); return Base64.getEncoder().encodeToString(salt); } /** * 使用SHA-256和盐值对密码进行哈希 * param password 明文密码 * param salt Base64编码的盐值 * return 十六进制格式的哈希值 */ public static String hashWithSalt(String password, String salt) throws Exception { MessageDigest md MessageDigest.getInstance(SHA-256); // 将盐值解码回字节数组 byte[] saltBytes Base64.getDecoder().decode(salt); // 先更新盐值 md.update(saltBytes); // 再更新密码 byte[] hashedBytes md.digest(password.getBytes(UTF-8)); // 将字节数组转换为十六进制字符串 StringBuilder sb new StringBuilder(); for (byte b : hashedBytes) { sb.append(String.format(%02x, b)); } return sb.toString(); } /** * 验证密码 * param password 待验证的明文密码 * param salt 存储的盐值 * param expectedHash 存储的哈希值 * return 验证是否通过 */ public static boolean verifyPassword(String password, String salt, String expectedHash) throws Exception { String actualHash hashWithSalt(password, salt); // 使用恒定时间比较避免计时攻击简化示例实际可用MessageDigest.isEqual return actualHash.equals(expectedHash); } public static void main(String[] args) throws Exception { String rawPassword MySuperSecretPassword123!; // 1. 生成并存储盐值 String salt generateSalt(16); System.out.println(生成的盐值 (Base64): salt); // 2. 计算并存储哈希值 String storedHash hashWithSalt(rawPassword, salt); System.out.println(存储的密码哈希: storedHash); // 3. 模拟登录验证 String inputPassword MySuperSecretPassword123!; boolean isCorrect verifyPassword(inputPassword, salt, storedHash); System.out.println(密码验证结果: (isCorrect ? 成功 : 失败)); // 4. 测试错误密码 String wrongPassword WrongPassword; isCorrect verifyPassword(wrongPassword, salt, storedHash); System.out.println(错误密码验证结果: (isCorrect ? 成功 (异常!) : 失败 (正常))); } }运行说明直接运行main方法你会看到盐值、哈希值的生成以及正确和错误密码的验证过程。4.2 对称加密实战AES/CBC/PKCS5Padding这是一个完整的AES加密解密示例包含了IV的处理。import javax.crypto.Cipher; import javax.crypto.KeyGenerator; import javax.crypto.SecretKey; import javax.crypto.spec.IvParameterSpec; import java.security.SecureRandom; import java.util.Base64; public class AesExample { public static final String ALGORITHM AES; public static final String TRANSFORMATION AES/CBC/PKCS5Padding; public static final int KEY_SIZE 128; // 也可以是 192 或 256但可能需要安装JCE无限制策略文件 /** * 生成AES密钥 */ public static SecretKey generateKey() throws Exception { KeyGenerator keyGen KeyGenerator.getInstance(ALGORITHM); keyGen.init(KEY_SIZE, new SecureRandom()); return keyGen.generateKey(); } /** * 生成随机的初始化向量 (IV) */ public static byte[] generateIv() { byte[] iv new byte[16]; // AES块大小是16字节 new SecureRandom().nextBytes(iv); return iv; } /** * 加密 * param plainText 明文 * param key 密钥 * param iv 初始化向量 * return Base64编码的密文 */ public static String encrypt(String plainText, SecretKey key, byte[] iv) throws Exception { Cipher cipher Cipher.getInstance(TRANSFORMATION); IvParameterSpec ivSpec new IvParameterSpec(iv); cipher.init(Cipher.ENCRYPT_MODE, key, ivSpec); byte[] encryptedBytes cipher.doFinal(plainText.getBytes(UTF-8)); return Base64.getEncoder().encodeToString(encryptedBytes); } /** * 解密 * param cipherText Base64编码的密文 * param key 密钥 * param iv 加密时使用的IV * return 明文 */ public static String decrypt(String cipherText, SecretKey key, byte[] iv) throws Exception { Cipher cipher Cipher.getInstance(TRANSFORMATION); IvParameterSpec ivSpec new IvParameterSpec(iv); cipher.init(Cipher.DECRYPT_MODE, key, ivSpec); byte[] decodedBytes Base64.getDecoder().decode(cipherText); byte[] decryptedBytes cipher.doFinal(decodedBytes); return new String(decryptedBytes, UTF-8); } public static void main(String[] args) throws Exception { String originalText 这是一段需要加密的敏感数据比如订单号202405200001; // 1. 生成密钥 (在实际应用中密钥需要安全存储不能每次生成) SecretKey secretKey generateKey(); System.out.println(AES密钥 (Base64): Base64.getEncoder().encodeToString(secretKey.getEncoded())); // 2. 生成IV (每次加密都必须使用新的随机IV) byte[] iv generateIv(); System.out.println(IV (Base64): Base64.getEncoder().encodeToString(iv)); // 3. 加密 String encryptedText encrypt(originalText, secretKey, iv); System.out.println(加密后的密文: encryptedText); // 4. 解密 String decryptedText decrypt(encryptedText, secretKey, iv); System.out.println(解密后的明文: decryptedText); // 5. 验证 System.out.println(原文与解密文是否一致: originalText.equals(decryptedText)); } }关键点注意TRANSFORMATION的完整定义以及IvParameterSpec的使用。IV需要和密文一起存储或传输给解密方。4.3 非对称加密实战RSA加密与签名这个示例展示了RSA的两种主要用途加密解密和数字签名/验证。import javax.crypto.Cipher; import java.security.*; import java.util.Base64; public class RsaExample { public static final String ALGORITHM RSA; public static final int KEY_SIZE 2048; /** * 生成RSA密钥对 */ public static KeyPair generateKeyPair() throws Exception { KeyPairGenerator keyPairGen KeyPairGenerator.getInstance(ALGORITHM); keyPairGen.initialize(KEY_SIZE, new SecureRandom()); return keyPairGen.generateKeyPair(); } /** * RSA加密 (使用公钥) * 注意RSA有长度限制加密的数据不能超过 (密钥长度/8 - 11) 字节 */ public static String encrypt(String plainText, PublicKey publicKey) throws Exception { Cipher cipher Cipher.getInstance(ALGORITHM); cipher.init(Cipher.ENCRYPT_MODE, publicKey); byte[] encryptedBytes cipher.doFinal(plainText.getBytes(UTF-8)); return Base64.getEncoder().encodeToString(encryptedBytes); } /** * RSA解密 (使用私钥) */ public static String decrypt(String cipherText, PrivateKey privateKey) throws Exception { Cipher cipher Cipher.getInstance(ALGORITHM); cipher.init(Cipher.DECRYPT_MODE, privateKey); byte[] decodedBytes Base64.getDecoder().decode(cipherText); byte[] decryptedBytes cipher.doFinal(decodedBytes); return new String(decryptedBytes, UTF-8); } /** * 使用私钥对数据进行签名 */ public static String sign(String data, PrivateKey privateKey) throws Exception { Signature signature Signature.getInstance(SHA256withRSA); signature.initSign(privateKey); signature.update(data.getBytes(UTF-8)); byte[] signBytes signature.sign(); return Base64.getEncoder().encodeToString(signBytes); } /** * 使用公钥验证签名 */ public static boolean verify(String data, String sign, PublicKey publicKey) throws Exception { Signature signature Signature.getInstance(SHA256withRSA); signature.initVerify(publicKey); signature.update(data.getBytes(UTF-8)); byte[] signBytes Base64.getDecoder().decode(sign); return signature.verify(signBytes); } public static void main(String[] args) throws Exception { String originalData 这是一段需要加密或签名的数据。RSA加密数据长度有限; // 1. 生成密钥对 KeyPair keyPair generateKeyPair(); PublicKey publicKey keyPair.getPublic(); PrivateKey privateKey keyPair.getPrivate(); System.out.println( RSA 加密解密演示 ); // 2. 加密 (公钥加密) String encryptedData encrypt(originalData, publicKey); System.out.println(加密后的数据: encryptedData); // 3. 解密 (私钥解密) String decryptedData decrypt(encryptedData, privateKey); System.out.println(解密后的数据: decryptedData); System.out.println(加解密验证: originalData.equals(decryptedData)); System.out.println(\n RSA 数字签名演示 ); // 4. 签名 (私钥签名) String signature sign(originalData, privateKey); System.out.println(生成的签名: signature); // 5. 验签 (公钥验签) boolean isValid verify(originalData, signature, publicKey); System.out.println(签名验证结果: (isValid ? 有效 : 无效)); // 6. 测试篡改数据后的验签 String tamperedData originalData 被篡改了; boolean isTamperedValid verify(tamperedData, signature, publicKey); System.out.println(数据篡改后签名验证结果: (isTamperedValid ? 有效 (异常!) : 无效 (正常))); } }重要提示RSA加密有明文长度限制。对于更长的数据标准做法是用RSA加密一个随机生成的对称密钥如AES密钥然后用这个对称密钥去加密实际数据。这就是“混合加密”。4.4 国密算法实战SM4加密解密国密算法在特定领域是必选项。这里以SM4对称加密为例。由于Java标准库不包含国密算法我们需要使用BouncyCastle提供商。首先添加BouncyCastle依赖Mavendependency groupIdorg.bouncycastle/groupId artifactIdbcprov-jdk15to18/artifactId version1.74/version !-- 使用最新版本 -- /dependency然后编写SM4示例代码import org.bouncycastle.jce.provider.BouncyCastleProvider; import javax.crypto.Cipher; import javax.crypto.KeyGenerator; import javax.crypto.SecretKey; import javax.crypto.spec.IvParameterSpec; import javax.crypto.spec.SecretKeySpec; import java.security.Security; import java.util.Base64; public class Sm4Example { static { // 在静态块中注册BouncyCastle提供商 Security.addProvider(new BouncyCastleProvider()); } public static final String ALGORITHM SM4; public static final String TRANSFORMATION SM4/CBC/PKCS5Padding; public static final int KEY_SIZE 128; // SM4密钥固定为128位 /** * 生成SM4密钥 */ public static SecretKey generateKey() throws Exception { KeyGenerator keyGen KeyGenerator.getInstance(ALGORITHM, BC); keyGen.init(KEY_SIZE); return keyGen.generateKey(); } /** * 加密 */ public static String encrypt(String plainText, SecretKey key, byte[] iv) throws Exception { Cipher cipher Cipher.getInstance(TRANSFORMATION, BC); IvParameterSpec ivSpec new IvParameterSpec(iv); cipher.init(Cipher.ENCRYPT_MODE, key, ivSpec); byte[] encryptedBytes cipher.doFinal(plainText.getBytes(UTF-8)); return Base64.getEncoder().encodeToString(encryptedBytes); } /** * 解密 */ public static String decrypt(String cipherText, SecretKey key, byte[] iv) throws Exception { Cipher cipher Cipher.getInstance(TRANSFORMATION, BC); IvParameterSpec ivSpec new IvParameterSpec(iv); cipher.init(Cipher.DECRYPT_MODE, key, ivSpec); byte[] decodedBytes Base64.getDecoder().decode(cipherText); byte[] decryptedBytes cipher.doFinal(decodedBytes); return new String(decryptedBytes, UTF-8); } public static void main(String[] args) throws Exception { String originalText 这是一段使用国密SM4加密的测试数据。; // 1. 生成密钥 SecretKey secretKey generateKey(); System.out.println(SM4密钥 (Base64): Base64.getEncoder().encodeToString(secretKey.getEncoded())); // 2. 生成IV (CBC模式需要) byte[] iv new byte[16]; // SM4块大小也是16字节 java.security.SecureRandom.getInstanceStrong().nextBytes(iv); System.out.println(IV (Base64): Base64.getEncoder().encodeToString(iv)); // 3. 加密 String encryptedText encrypt(originalText, secretKey, iv); System.out.println(SM4加密后的密文: encryptedText); // 4. 解密 String decryptedText decrypt(encryptedText, secretKey, iv); System.out.println(SM4解密后的明文: decryptedText); // 5. 验证 System.out.println(原文与解密文是否一致: originalText.equals(decryptedText)); } }5. 常见问题与排查技巧实录在实际开发和调试中你会遇到各种各样的问题。下面是我总结的一些高频问题和解决方法。5.1 异常与错误排查速查表异常信息可能原因解决方案NoSuchAlgorithmException1. 算法名称拼写错误。2. 未安装相应的JCE提供者如国密算法。1. 检查算法字符串如AES/CBC/PKCS5Padding。2. 添加对应的Jar包如BouncyCastle并注册Security.addProvider()。InvalidKeyException1. 密钥长度不符合算法要求。2. 密钥类型错误如用RSA公钥做AES解密。3. 密钥已损坏或格式不正确。1. 确认密钥长度如AES-128/192/256。2. 检查加解密使用的密钥是否配对公钥加密私钥解。3. 检查密钥生成、存储、加载过程。BadPaddingException1. 解密时使用的密钥与加密时不一致。2. 加密模式或填充方案不匹配。3. 密文在传输过程中被损坏或篡改。1.最常见原因确保加解密使用同一个密钥。2. 确保Cipher.getInstance()的算法字符串完全一致。3. 检查Base64编解码过程或网络传输是否完整。IllegalBlockSizeException1. RSA加密的明文长度超限。2. 使用CBC等模式时未正确设置IV或IV错误。1. RSA加密前检查明文长度 ≤ (密钥长度/8 - 11)。对于长数据改用“混合加密”。2. 确保解密时使用的IV与加密时相同。AEADBadTagException(GCM模式)密文或附加认证数据(AAD)在传输中被篡改。GCM模式提供了完整性校验。此异常表明数据已被破坏应拒绝处理。检查数据传输的完整性。5.2 性能优化与最佳实践密钥管理是核心对称密钥绝不能硬编码在代码中。应使用安全的密钥管理系统如HashiCorp Vault、AWS KMS或从安全的配置中心获取。非对称密钥对私钥必须存放在受保护的位置如硬件安全模块HSM、操作系统密钥库。公钥可以公开。算法与参数选择弃用弱算法坚决不使用DES、MD5、SHA-1、RSA-1024以及ECB模式。使用强随机数密钥、盐值、IV的生成必须使用密码学安全的随机数生成器SecureRandom而不是Random或Math.random()。TLS/SSL连接在配置HTTPS服务器时禁用已知的弱加密套件如搜索词中提到的SSL弱加密算法只启用强算法套件如TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384。数据长度处理对于对称加密AES如果数据不是块大小的整数倍需要填充。PKCS5Padding是通用选择。对于非对称加密RSA只能加密很短的数据。长数据务必采用“混合加密”生成一个随机的对称密钥会话密钥用RSA公钥加密它然后用这个对称密钥加密实际数据。将加密后的会话密钥和加密后的数据一起发送。版本兼容性Java默认的JCE策略文件可能限制密钥长度如AES-256。如果需要使用无限制强度加密策略需从Oracle官网下载并替换JRE_HOME/lib/security/下的策略文件。使用国密等非标准算法时明确指定提供商如BC并确保运行环境中有对应的Jar包。5.3 调试与验证技巧从简单开始验证先用固定的、简单的明文如Hello, World!、密钥和IV进行加密解密确保基础流程正确。再逐步替换为随机生成的值。打印关键中间值在调试时可以将生成的密钥、IV、加密前后的字节数组用Base64或Hex打印都输出到日志中对比加解密前后是否一致。跨语言/平台交互如果你的Java后端需要和前端JavaScript或其他语言如Python进行加解密交互务必确认双方使用的算法、模式、填充、密钥格式、IV处理方式、字符编码完全一致。一个字节的差异都会导致失败。通常明确指定所有参数并做好文档是关键。单元测试为你的加密工具类编写完善的单元测试覆盖正常流程、错误密码、错误密钥、空数据等边界情况。
