1. 项目背景与核心需求在Web应用开发中前端与后端的数据安全传输一直是关键问题。SM2作为国密标准中的非对称加密算法相比RSA具有更高的安全性和更快的运算速度。实际项目中经常遇到这样的场景前端使用JavaScript生成SM2密钥对并加密敏感数据后端Java服务需要正确解密这些数据。这个技术组合的难点在于确保两端加密解密参数的完全匹配包括曲线参数、填充模式、编码方式等细节。最近在金融项目对接中就遇到了一个典型问题前端使用sm-crypto库加密的用户身份证号后端Java解密总是失败。经过排查发现是C1C3C2和C1C2C3两种密文顺序不匹配导致的。这类问题在跨语言加密交互中非常普遍需要开发者对SM2标准有深入理解。2. 环境准备与工具选型2.1 前端加密方案推荐使用sm-crypto这个经过验证的国密算法JS实现npm install sm-crypto --save这个库的优势在于完整实现SM2/SM3/SM4算法支持压缩公钥66位16进制提供多种签名验签模式活跃的GitHub社区维护2.2 后端解密方案Java端推荐采用Bouncy Castle作为加密提供商dependency groupIdorg.bouncycastle/groupId artifactIdbcprov-jdk15on/artifactId version1.70/version /dependency需要特别注意必须使用支持国密的BC版本注册Provider时需要明确指定算法支持Security.addProvider(new BouncyCastleProvider());3. 核心实现细节3.1 前端加密关键代码const sm2 require(sm-crypto).sm2; // 生成密钥对 const keypair sm2.generateKeyPairHex(); const publicKey keypair.publicKey; // 04开头的未压缩公钥 // 加密配置 const cipherMode 1; // 1-C1C3C2, 0-C1C2C3 const msg 待加密敏感数据; // 执行加密 const encryptData sm2.doEncrypt(msg, publicKey, cipherMode);关键参数说明cipherMode1采用C1C3C2顺序与Java端默认一致公钥需要包含04前缀表示未压缩默认使用SM3作为哈希算法3.2 后端解密关键代码import org.bouncycastle.jce.provider.BouncyCastleProvider; import org.bouncycastle.util.encoders.Hex; public class SM2Decryptor { static { Security.addProvider(new BouncyCastleProvider()); } public static String decrypt(String encryptedData, String privateKey) throws Exception { // 转换私钥 ECPrivateKeyParameters ecPrivateKey getPrivateKey(privateKey); // 配置解密参数 SM2Engine engine new SM2Engine(SM2Engine.Mode.C1C3C2); CipherParameters params new ParametersWithRandom(ecPrivateKey); engine.init(false, params); // 执行解密 byte[] cipherBytes Hex.decode(encryptedData); byte[] decrypted engine.processBlock(cipherBytes, 0, cipherBytes.length); return new String(decrypted, StandardCharsets.UTF_8); } private static ECPrivateKeyParameters getPrivateKey(String privateKeyHex) { BigInteger d new BigInteger(privateKeyHex, 16); ECNamedCurveParameterSpec sm2Spec ECNamedCurveTable.getParameterSpec(sm2p256v1); ECDomainParameters domainParams new ECDomainParameters( sm2Spec.getCurve(), sm2Spec.getG(), sm2Spec.getN()); return new ECPrivateKeyParameters(d, domainParams); } }关键点解析必须指定SM2Engine.Mode.C1C3C2与前端的cipherMode1对应使用相同的椭圆曲线参数sm2p256v1私钥需要去除可能的04前缀4. 常见问题与解决方案4.1 解密失败排查清单问题现象可能原因解决方案Invalid point encoding公钥格式不匹配确保前端使用未压缩公钥(04开头)Invalid ciphertext密文顺序不匹配检查两端C1C3C2/C1C2C3配置是否一致Message too shortBase64解码问题使用Hex.decode而非Base64Invalid privateKey私钥格式错误检查是否包含多余字符或错误前缀4.2 性能优化建议前端缓存密钥对避免每次加密都生成新密钥对// 将密钥对存入sessionStorage sessionStorage.setItem(sm2_keypair, JSON.stringify(keypair));Java端使用静态Engineprivate static final SM2Engine ENGINE; static { ENGINE new SM2Engine(SM2Engine.Mode.C1C3C2); }启用压缩公钥减少传输数据量const compressed sm2.compressPublicKeyHex(publicKey);5. 进阶应用场景5.1 签名验签实现前端签名const sig sm2.doSignature(msg, privateKey, { der: true, userId: user123 });后端验签SM2Signer signer new SM2Signer(); signer.init(false, new ParametersWithID( new ParametersWithRandom(publicKeyParams), user123.getBytes() )); signer.update(msg.getBytes(), 0, msg.length()); boolean valid signer.verifySignature(signatureBytes);5.2 与HTTPS的配合使用虽然SM2提供了端到端加密但仍建议保持HTTPS作为传输层安全使用SM2加密敏感字段而非全部内容实现加密元数据(密钥ID、算法版本)的协商机制6. 安全注意事项密钥管理前端生成的私钥仅限会话内使用服务端私钥必须使用HSM或KMS保护禁止硬编码密钥在代码中防重放攻击const timestamp Date.now(); const nonce crypto.randomBytes(8).toString(hex); const payload ${msg}|${timestamp}|${nonce}; const encrypted sm2.doEncrypt(payload, publicKey);输入验证if(encryptedData.length() 8192) { throw new IllegalArgumentException(密文过长); }在实际项目中我们通过这套方案成功实现了百万级用户数据的加密传输平均加解密耗时控制在50ms以内。特别要注意的是测试阶段必须验证各种边界情况包括空数据、超长数据、特殊字符等情况下的处理。