1. 项目概述与核心价值最近在重构一个对安全性要求比较高的后台管理系统客户明确要求登录环节的密码传输必须使用国密算法进行加密。我们团队的技术栈是基于若依RuoYi前后端分离版进行开发的这本身是一个成熟且高效的框架但其默认的登录密码传输是明文或经过前端MD5哈希后传输的这在当前的安全环境下显然不够看。于是我花了大概一周的时间完整地走通了将SM2国密算法整合进若依框架的整个流程从前端的密码加密到后端的密钥对管理、解密验签再到与现有用户体系的平滑对接。整个过程踩了不少坑也积累了一些在官方文档里找不到的实战经验今天就把这个“若依框架整合SM2国密算法”的完整实践过程分享出来。简单来说这个实践要解决的核心问题就是在用户登录时前端页面使用SM2公钥对用户输入的密码进行加密生成密文后端服务使用对应的SM2私钥对密文进行解密还原出原始密码再进行后续的密码校验和登录逻辑。这确保了密码在传输过程中即使被截获攻击者没有私钥也无法解密极大地提升了认证过程的安全性。整个方案不仅适用于登录其核心的“前端加密-后端解密”模式完全可以复用到其他敏感数据传输场景中。2. 技术选型与整体架构设计在动手之前明确技术选型是第一步。SM2作为国家密码管理局发布的椭圆曲线公钥密码算法其Java实现有很多比如Bouncy Castle、国产的sm-crypto配套Java库等。考虑到若依框架本身是Spring Boot技术栈且需要与前端sm-crypto库无缝对接我最终选择了**org.bouncycastle:bcprov-jdk15on** 这个广泛使用的加密库它提供了对SM2、SM3、SM4等国密算法的完整支持成熟稳定社区资源丰富。前端方面sm-crypto是一个纯JavaScript实现的国密算法库由腾讯团队维护轻量且API友好完美契合Vue技术栈的若依前端。这里有一个关键点SM2加密后的结果通常是一个04开头的十六进制字符串代表未压缩的公钥点格式或者经过ASN.1 DER编码的密文。为了确保前后端加解密能成功对接必须统一数据格式。经过测试sm-crypto默认生成的密文格式与Bouncy Castle的SM2Engine解密所需的格式是兼容的这省去了我们自行编解码的麻烦。整体架构设计上我遵循了“配置化”和“非侵入式”的原则。核心思路是后端生成SM2密钥对在应用启动时或通过一个管理接口生成一对SM2公私钥。公钥提供给前端用于加密私钥由后端安全保存通常放在配置文件或数据库中生产环境建议加密存储。前端集成加密逻辑改造若依前端的登录组件src/views/login.vue在用户点击登录时先使用从后端获取的公钥对密码进行SM2加密然后将密文作为password参数提交。后端改造登录接口拦截登录请求通常是/login在Spring Security或若依的自定义认证逻辑执行前使用私钥对密文进行解密将解密得到的明文密码替换回请求参数中后续的密码校验流程无需任何改动。异常处理与降级考虑到兼容性和未来可能的算法升级设计上要支持加密/非加密请求的自动识别与处理避免“一刀切”导致现有功能或测试用例失败。这个设计的巧妙之处在于它对若依框架原有的用户认证逻辑如密码加密器PasswordEncoder、用户详情服务UserDetailsService几乎是零侵入的。我们只是在请求进入核心业务逻辑前加了一个“解密过滤器”或“参数解析器”将密文还原为明文后面的流程照旧运行。这种“装饰器”模式使得整个整合过程清晰、可控也易于维护和回滚。3. 后端核心实现密钥管理与解密服务后端的实现是整个流程的基石主要集中在密钥的管理和解密服务的构建上。我将其拆解为几个核心步骤。3.1 引入依赖与密钥对生成首先在项目的pom.xml中添加Bouncy Castle依赖。注意版本号建议使用较新的稳定版。dependency groupIdorg.bouncycastle/groupId artifactIdbcprov-jdk15on/artifactId version1.70/version !-- 请检查并使用最新稳定版本 -- /dependency接下来是生成SM2密钥对。我选择在应用启动时自动生成并加载同时提供了手动触发生成的API以备不时之需。这里将生成逻辑封装在一个Sm2KeyPairGenerator工具类中。import org.bouncycastle.asn1.gm.GMNamedCurves; import org.bouncycastle.asn1.x9.X9ECParameters; import org.bouncycastle.crypto.AsymmetricCipherKeyPair; import org.bouncycastle.crypto.generators.ECKeyPairGenerator; import org.bouncycastle.crypto.params.ECDomainParameters; import org.bouncycastle.crypto.params.ECKeyGenerationParameters; import org.bouncycastle.crypto.params.ECPrivateKeyParameters; import org.bouncycastle.crypto.params.ECPublicKeyParameters; import org.bouncycastle.jce.provider.BouncyCastleProvider; import org.bouncycastle.math.ec.ECPoint; import org.bouncycastle.util.encoders.Hex; import java.security.Security; import java.util.Base64; public class Sm2KeyPairGenerator { static { // 确保BouncyCastle提供者被注册 if (Security.getProvider(BouncyCastleProvider.PROVIDER_NAME) null) { Security.addProvider(new BouncyCastleProvider()); } } /** * 生成SM2密钥对 * return 包含公钥(十六进制压缩格式)和私钥(十六进制)的Map */ public static MapString, String generateKeyPair() { try { // 获取SM2椭圆曲线参数 X9ECParameters sm2ECParameters GMNamedCurves.getByName(sm2p256v1); ECDomainParameters domainParameters new ECDomainParameters( sm2ECParameters.getCurve(), sm2ECParameters.getG(), sm2ECParameters.getN(), sm2ECParameters.getH() ); // 生成密钥对 ECKeyPairGenerator keyPairGenerator new ECKeyPairGenerator(); ECKeyGenerationParameters keyGenerationParameters new ECKeyGenerationParameters(domainParameters, new SecureRandom()); keyPairGenerator.init(keyGenerationParameters); AsymmetricCipherKeyPair keyPair keyPairGenerator.generateKeyPair(); // 提取私钥 (大整数) ECPrivateKeyParameters privateKeyParams (ECPrivateKeyParameters) keyPair.getPrivate(); String privateKeyHex privateKeyParams.getD().toString(16); // 私钥固定为64位十六进制不足补0 privateKeyHex String.format(%64s, privateKeyHex).replace( , 0); // 提取公钥 (椭圆曲线点) ECPublicKeyParameters publicKeyParams (ECPublicKeyParameters) keyPair.getPublic(); ECPoint publicKeyPoint publicKeyParams.getQ(); // 将公钥点转换为压缩格式的十六进制字符串以02或03开头 byte[] publicKeyEncoded publicKeyPoint.getEncoded(true); String publicKeyHex Hex.toHexString(publicKeyEncoded); MapString, String keyPairMap new HashMap(); keyPairMap.put(privateKey, privateKeyHex); keyPairMap.put(publicKey, publicKeyHex); return keyPairMap; } catch (Exception e) { throw new RuntimeException(生成SM2密钥对失败, e); } } }注意这里公钥我选择了压缩格式getEncoded(true)。压缩格式的公钥以02或03开头长度是66个十六进制字符33字节比未压缩格式04开头130字符更短更适合网络传输。sm-crypto库同样支持压缩格式的公钥但需要确认其encrypt方法是否自动识别。实测表明传入压缩公钥sm-crypto可以正常加密。生成后的密钥对需要持久化。在开发环境我可以将其放在application.yml中。但在生产环境私钥的安全性至关重要。我建议的做法是将私钥存储在安全的配置中心如阿里云ACM、HashiCorp Vault。或者将私钥加密后存入数据库启动时解密加载。绝对避免将私钥硬编码在代码或明文配置文件中。在我的实现中我创建了一个Sm2Properties配置类来管理密钥并通过PostConstruct在Bean初始化后从数据库或配置中心加载。3.2 构建SM2解密服务有了私钥下一步就是构建解密服务。这里的关键是理解sm-crypto加密后数据的格式并使用Bouncy Castle正确解密。我创建了一个Sm2Service。import org.bouncycastle.asn1.gm.GMNamedCurves; import org.bouncycastle.asn1.x9.X9ECParameters; import org.bouncycastle.crypto.engines.SM2Engine; import org.bouncycastle.crypto.params.ECDomainParameters; import org.bouncycastle.crypto.params.ECPrivateKeyParameters; import org.bouncycastle.crypto.params.ParametersWithRandom; import org.bouncycastle.jce.provider.BouncyCastleProvider; import org.bouncycastle.math.ec.ECCurve; import org.bouncycastle.util.encoders.Hex; import org.springframework.beans.factory.annotation.Value; import org.springframework.stereotype.Service; import java.math.BigInteger; import java.security.Security; Service public class Sm2Service { Value(${sm2.private-key}) private String privateKeyHex; /** * 解密SM2密文 * param cipherTextHex 十六进制格式的SM2密文 * return 解密后的明文 */ public String decrypt(String cipherTextHex) { try { // 再次确保Provider被注册 if (Security.getProvider(BouncyCastleProvider.PROVIDER_NAME) null) { Security.addProvider(new BouncyCastleProvider()); } // 1. 获取SM2曲线参数 X9ECParameters sm2ECParameters GMNamedCurves.getByName(sm2p256v1); ECDomainParameters domainParameters new ECDomainParameters( sm2ECParameters.getCurve(), sm2ECParameters.getG(), sm2ECParameters.getN(), sm2ECParameters.getH() ); // 2. 还原私钥参数 BigInteger privateKeyD new BigInteger(privateKeyHex, 16); ECPrivateKeyParameters privateKeyParams new ECPrivateKeyParameters(privateKeyD, domainParameters); // 3. 初始化SM2解密引擎 // SM2Engine.Mode.C1C3C2 是默认模式与sm-crypto生成的数据格式匹配 SM2Engine sm2Engine new SM2Engine(SM2Engine.Mode.C1C3C2); sm2Engine.init(false, privateKeyParams); // false 表示解密模式 // 4. 执行解密 byte[] cipherTextBytes Hex.decode(cipherTextHex); byte[] decryptedBytes sm2Engine.processBlock(cipherTextBytes, 0, cipherTextBytes.length); // 5. 返回解密后的字符串 return new String(decryptedBytes, StandardCharsets.UTF_8); } catch (Exception e) { throw new RuntimeException(SM2解密失败密文: cipherTextHex, e); } } /** * 提供一个获取公钥的接口供前端调用 */ public String getPublicKey() { // 这里从配置或数据库中读取公钥我假设也配置在sm2.public-key中 // 实际可能需从与私钥对应的密钥对信息中获取 // return publicKeyHex; // 简化示例直接返回配置值 // 注意需要有一个地方存储与私钥配对的公钥 // 更好的做法是生成密钥对时将公私钥一并存储此处查询返回 return “从你的存储中获取公钥”; } }踩坑实录SM2Engine.Mode的选择这是整合过程中最大的一个坑。Bouncy Castle的SM2Engine支持两种模式C1C3C2和C1C2C3。它们代表了密文中各部分C1: 椭圆曲线点C2: 密文C3: SM3摘要的排列顺序。sm-crypto默认生成的密文格式是C1C3C2。如果后端解密时模式选错会直接导致解密失败抛出异常。我一开始没注意这个细节浪费了不少时间排查。务必确保前后端模式一致。上述代码中使用的SM2Engine.Mode.C1C3C2是与sm-crypto默认行为匹配的。3.3 集成到Spring Security认证流程若依前后端分离版默认使用Spring Security处理登录。我们需要在密码被PasswordEncoder校验之前将密文解密。最优雅的方式是使用一个过滤器Filter或者一个自定义的AuthenticationConverter。我选择了实现一个Sm2DecryptFilter并将其插入到Spring Security过滤器链中UsernamePasswordAuthenticationFilter之前。import com.ruoyi.common.core.domain.AjaxResult; import com.ruoyi.common.utils.StringUtils; import com.fasterxml.jackson.databind.ObjectMapper; import lombok.extern.slf4j.Slf4j; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.security.web.util.matcher.AntPathRequestMatcher; import org.springframework.stereotype.Component; import org.springframework.web.filter.OncePerRequestFilter; import javax.servlet.FilterChain; import javax.servlet.ServletException; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import java.io.BufferedReader; import java.io.IOException; import java.util.Map; Component Slf4j public class Sm2DecryptFilter extends OncePerRequestFilter { private static final AntPathRequestMatcher LOGIN_MATCHER new AntPathRequestMatcher(/login, POST); private static final String PASSWORD_PARAM password; Autowired private Sm2Service sm2Service; Autowired private ObjectMapper objectMapper; Override protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain chain) throws ServletException, IOException { // 1. 仅处理登录请求 if (!LOGIN_MATCHER.matches(request)) { chain.doFilter(request, response); return; } // 2. 缓存请求体以便多次读取 CachedBodyHttpServletRequest cachedBodyRequest new CachedBodyHttpServletRequest(request); // 3. 尝试解析请求体中的密码参数 String passwordParam null; try { String body getRequestBody(cachedBodyRequest); MapString, Object paramMap objectMapper.readValue(body, Map.class); passwordParam (String) paramMap.get(PASSWORD_PARAM); } catch (Exception e) { log.warn(解析登录请求体失败可能不是JSON格式或未加密继续走原始流程, e); chain.doFilter(cachedBodyRequest, response); return; } // 4. 判断密码是否需要解密可根据长度、前缀等特征判断这里简单判断非空 if (StringUtils.isNotEmpty(passwordParam) passwordParam.length() 64) { // SM2密文通常较长 try { log.debug(尝试解密SM2密码密文); String decryptedPassword sm2Service.decrypt(passwordParam); // 5. 将解密后的密码写回请求参数Map并重新设置到请求中 // 这里需要修改缓存中的请求体数据 modifyRequestBody(cachedBodyRequest, PASSWORD_PARAM, decryptedPassword); log.debug(SM2密码解密成功); } catch (Exception e) { log.error(SM2解密失败密文: {}, passwordParam, e); // 解密失败可以返回错误信息这里选择继续传递原始密文由后续逻辑处理会校验失败 // 也可以直接返回错误响应 handleDecryptFailure(response, 密码解密失败请检查加密方式); return; } } // 6. 继续过滤器链 chain.doFilter(cachedBodyRequest, response); } private String getRequestBody(HttpServletRequest request) throws IOException { StringBuilder stringBuilder new StringBuilder(); BufferedReader bufferedReader request.getReader(); char[] charBuffer new char[1024]; int bytesRead; while ((bytesRead bufferedReader.read(charBuffer)) ! -1) { stringBuilder.append(charBuffer, 0, bytesRead); } return stringBuilder.toString(); } private void modifyRequestBody(CachedBodyHttpServletRequest request, String key, String newValue) throws IOException { // 实现修改缓存请求体中JSON数据的逻辑 // 这里需要自定义CachedBodyHttpServletRequest来支持body的修改和重新读取 // 篇幅所限具体实现略。核心是读取原body - 解析为Map - 修改password值 - 序列化回JSON - 存入缓存 request.updateBodyForKey(key, newValue); } private void handleDecryptFailure(HttpServletResponse response, String msg) throws IOException { response.setContentType(application/json;charsetUTF-8); response.setStatus(HttpServletResponse.SC_BAD_REQUEST); AjaxResult ajaxResult AjaxResult.error(msg); response.getWriter().write(objectMapper.writeValueAsString(ajaxResult)); } }实操心得请求体的缓存与修改HttpServletRequest的getInputStream()或getReader()通常只能读取一次。为了在过滤器中读取并修改请求体我们必须自己实现一个CachedBodyHttpServletRequest包装类将原始的输入流数据缓存起来并允许后续过滤器链读取修改后的数据。这是实现这个过滤器的技术关键点之一。网上有很多现成的实现核心就是用一个byte[]或ByteArrayInputStream来缓存ServletRequest的输入流。最后需要在Spring Security的配置类通常是SecurityConfig中注册这个过滤器。Configuration EnableWebSecurity public class SecurityConfig extends WebSecurityConfigurerAdapter { Autowired private Sm2DecryptFilter sm2DecryptFilter; Override protected void configure(HttpSecurity http) throws Exception { http // ... 其他配置 (csrf, session等) .addFilterBefore(sm2DecryptFilter, UsernamePasswordAuthenticationFilter.class) // 关键在认证前解密 .authorizeRequests() // ... 授权配置 .and() .formLogin() // ... 登录页面等配置 } }这样当登录请求到达时会先经过Sm2DecryptFilter。过滤器识别出是登录请求后提取password字段如果判断为SM2密文例如长度特征就调用Sm2Service解密并将解密后的明文密码写回请求中。随后请求才到达UsernamePasswordAuthenticationFilterSpring Security会使用写回的明文密码去进行后续的校验整个过程对原有的认证逻辑透明。4. 前端改造集成sm-crypto与登录加密后端准备好之后前端的改造相对直接。目标是在用户点击登录时用后端提供的SM2公钥对密码进行加密然后提交密文。4.1 安装与引入sm-crypto在若依前端项目Vue中使用npm或yarn安装sm-crypto。npm install sm-crypto --save # 或 yarn add sm-crypto然后我创建了一个工具文件src/utils/sm2.js封装加密方法。import { sm2 } from sm-crypto; /** * SM2加密工具 */ const Sm2Util { /** * 使用公钥加密文本 * param {string} plainText 明文 * param {string} publicKey 十六进制压缩公钥 (以02或03开头66字符) * param {string} cipherMode 加密模式默认 C1C3C2 * returns {string} 十六进制密文 */ encrypt(plainText, publicKey, cipherMode C1C3C2) { if (!plainText || !publicKey) { console.error(SM2加密参数缺失); return plainText; // 或抛出错误 } try { // sm2.doEncrypt 返回的是16进制字符串 const cipherTextHex sm2.doEncrypt(plainText, publicKey, 1); // 第三个参数1表示输出为16进制 return cipherTextHex; } catch (error) { console.error(SM2加密失败:, error); throw new Error(密码加密处理失败请重试); } }, /** * 从后端获取SM2公钥 (通常通过接口获取) * 这里模拟一个获取公钥的方法实际应从API获取 */ async fetchPublicKey() { // 假设有一个API接口 /api/publicKey/sm2 返回公钥 // const { data } await axios.get(/api/publicKey/sm2); // return data.publicKey; // 开发阶段可以先写死后续替换为API调用 console.warn(使用本地配置的公钥请确保与后端匹配); return ‘02...你的压缩公钥...’; // 替换为你的公钥 } }; export default Sm2Util;4.2 改造登录组件接下来找到若依的登录页面组件通常是src/views/login.vue。修改其登录提交方法。template !-- 原有模板代码不变 -- /template script import { encrypt } from /utils/rsa // 若依原有的RSA加密我们可能不再需要 import Sm2Util from /utils/sm2; // 引入我们的SM2工具 import { getCodeImg, login, logout, getInfo } from /api/login; export default { name: Login, data() { return { // ... 原有data属性 loginForm: { username: admin, password: admin123, // ... 其他字段 }, sm2PublicKey: , // 存储从后端获取的公钥 // ... }; }, created() { // 页面创建时获取SM2公钥 this.fetchSm2PublicKey(); // ... 其他初始化 }, methods: { // 新增方法获取SM2公钥 async fetchSm2PublicKey() { try { // 调用后端接口获取公钥这里需要你根据后端实现的接口来调用 // const response await this.$axios.get(/system/publicKey/sm2); // this.sm2PublicKey response.data.data; // 临时直接使用工具类中的方法实际应从接口获取 this.sm2PublicKey await Sm2Util.fetchPublicKey(); } catch (error) { console.error(获取SM2公钥失败登录加密功能不可用, error); // 可以降级为不加密或使用其他方式这里简单提示 this.$message.warning(安全模块加载失败登录可能不安全); } }, // 修改登录方法 handleLogin() { this.$refs.loginForm.validate(valid { if (valid) { this.loading true; // 1. 复制登录表单数据 let loginData { ...this.loginForm }; // 2. 对密码进行SM2加密 (如果公钥可用) if (this.sm2PublicKey this.loginForm.password) { try { const encryptedPassword Sm2Util.encrypt(this.loginForm.password, this.sm2PublicKey); loginData.password encryptedPassword; // 替换为密文 console.debug(密码已进行SM2加密); } catch (encryptError) { console.error(密码加密失败使用原始密码提交不安全, encryptError); this.$message.error(密码加密失败请重试或联系管理员); this.loading false; return; // 加密失败中止登录 } } else { console.warn(SM2公钥未获取或密码为空密码将以明文或原有方式传输); // 这里可以决定是否允许继续为了安全建议不允许 // this.$message.error(安全模块未就绪禁止登录); // this.loading false; // return; } // 3. 调用登录API提交加密后的数据 login(loginData).then((res) { // ... 原有登录成功处理逻辑 this.loading false; }).catch((error) { // ... 原有登录失败处理逻辑 this.loading false; }); } else { console.log(表单验证失败!); return false; } }); }, // ... 其他原有方法 } }; /script注意事项前端公钥的管理动态获取公钥不应该硬编码在前端。最佳实践是在应用初始化或登录页面加载时通过一个单独的API接口从后端获取。这提供了密钥轮转的灵活性。错误处理必须做好加密失败的处理。如果获取公钥失败或加密过程出错要有降级或明确的错误提示避免用户困惑。在生产环境中可能直接禁止在加密不可用时登录。避免缓存确保每次获取的公钥是最新的特别是计划定期更换密钥对时。至此一个完整的前端加密、后端解密的SM2整合流程就实现了。用户在前端输入密码点击登录时密码被SM2公钥加密密文传输到后端后端的过滤器拦截请求用对应的私钥解密然后将明文密码交给Spring Security处理最终完成登录认证。5. 进阶优化与生产环境考量基础功能跑通后还需要考虑更多生产级别的细节确保方案的健壮性和安全性。5.1 密钥轮转与多版本支持一套密钥长期使用存在风险。我们需要支持密钥轮转。我的设计是后端维护一个“当前生效”的密钥对ID如版本号v1。提供一个接口/api/publicKey/current返回当前公钥及其ID。前端登录时先调用该接口获取最新公钥和ID然后用该公钥加密并在请求头如X-SM2-Key-Id: v1中携带密钥ID。后端解密过滤器根据请求头中的ID从密钥库数据库或缓存中加载对应的私钥进行解密。管理员后台可以生成新密钥对v2并将current指向v2。旧版本密钥在一定过渡期内仍需保留以处理尚未刷新公钥的前端请求或已加密的缓存请求。5.2 性能监控与异常熔断SM2加解密是CPU密集型操作。在高并发登录场景下需要关注其性能影响。监控在Sm2Service的decrypt方法和前端加密处添加耗时监控如通过Micrometer或自定义AOP。熔断如果解密服务连续失败或超时可以考虑在过滤器中暂时绕过解密逻辑记录告警让请求走原始流程当然这降低了安全性防止因加密模块问题导致整个登录功能不可用。日志脱敏切记不要在日志中完整记录密文或解密后的明文密码使用...替换部分字符即可。5.3 与现有密码加密器的协同若依框架可能已经配置了BCryptPasswordEncoder或其它PasswordEncoder。我们的解密发生在PasswordEncoder之前因此完全不影响。流程是前端密文 - 解密过滤器 - 明文密码 - UsernamePasswordAuthenticationFilter - DaoAuthenticationProvider - UserDetailsService.loadUserByUsername - PasswordEncoder.matches(明文密码, 数据库哈希密码)数据库存储的仍然是经过BCrypt等哈希的密码安全性由哈希算法保障传输安全性由SM2保障两者职责清晰。5.4 接口防重放与数据完整性仅加密可以防止密码泄露但无法防止攻击者截获加密后的密文进行重放攻击。为了进一步提升安全性可以考虑加入随机数Nonce和时间戳前端加密时可以将密码、时间戳和一个随机数拼接后再加密。后端解密后校验时间戳的有效期如5分钟内并检查随机数是否已被使用过需缓存已使用的随机数短期有效。结合SM3摘要对请求体整体计算SM3摘要并将摘要值一同传输后端验证数据完整性。这可以防止密文在传输中被篡改。6. 常见问题排查与实战技巧在开发和测试过程中我遇到了不少问题这里总结一下最常见的几个及其解决方法。问题一后端解密失败报错“Invalid point encoding”或“Malformed input”。可能原因1前后端数据格式不一致。前端sm-crypto加密后默认是C1C3C2顺序的16进制字符串。后端SM2Engine初始化时必须使用SM2Engine.Mode.C1C3C2。请仔细检查。可能原因2公钥格式不匹配。确保前端使用的公钥与后端用于解密的私钥是配对的。并且确认公钥格式压缩02/03开头66位Hex或未压缩04开头130位Hex与sm-crypto的encrypt方法兼容。建议统一使用压缩格式。可能原因3密文在传输过程中被编码改变。确保密文以字符串形式在HTTP Body中传输没有发生意外的URL编码或Base64编码除非你主动做了。使用抓包工具如Fiddler、Charles对比前端发送和后端接收到的password字段值是否完全一致。问题二前端加密后登录一直提示“用户名或密码错误”。排查步骤前端加密检查在浏览器控制台打印加密前的明文密码和加密后的密文。确保公钥正确加载且加密过程没有报错。后端解密检查在Sm2DecryptFilter或Sm2Service.decrypt方法入口处打印接收到的密文。然后尝试用本地保存的私钥写一个单元测试或main方法对这个密文进行解密看是否能得到正确的明文。这一步能隔离出是传输问题还是解密问题。过滤器链路检查确认Sm2DecryptFilter确实被正确添加到过滤器链且顺序在UsernamePasswordAuthenticationFilter之前。可以在过滤器中打日志确认请求经过了它。密码对比将后端解密得到的明文与用户前端实际输入的明文进行对比确认是否一致。问题三集成后系统原有的非加密登录方式如内部接口调用、测试用例失败了。解决方案在解密过滤器中实现降级策略。例如通过请求头X-Encrypt-Type: SM2来显式声明本次请求使用了SM2加密。如果没有这个头则跳过解密逻辑。或者像我的示例代码中那样通过密码字段的长度、字符特征是否全是十六进制字符来智能判断。对于测试用例可以专门配置一个不启用该过滤器的测试环境。问题四在高并发下登录接口响应变慢。分析SM2解密操作相对耗时。单个请求可能感觉不明显但并发量高时CPU压力会增大。优化方向密钥缓存确保Sm2Service中的ECPrivateKeyParameters等对象是初始化好的而不是每次解密都重新构造。连接池SM2解密是无状态的不需要连接池。性能瓶颈主要在CPU计算。硬件加速调研服务器CPU是否支持国密指令集加速如果支持Bouncy Castle或一些国产密码库可能会利用到。限流与扩容对登录接口实施适当的限流并根据监控指标进行水平扩容。一个实用的调试技巧创建测试端点在开发阶段我强烈建议创建一个简单的测试Controller用于验证加解密链路是否通畅。RestController RequestMapping(/test/sm2) public class Sm2TestController { Autowired private Sm2Service sm2Service; GetMapping(/encrypt) public String testEncrypt(RequestParam String plainText) { // 注意这个接口仅用于测试生产环境应关闭或严格限制访问 // 这里模拟前端加密需要公钥。可以调用Sm2Service中获取公钥的方法。 // 实际测试时你可以手动用前端的公钥加密一段文本然后调用下面的解密接口验证。 return “请使用前端公钥加密文本: ” plainText; } PostMapping(/decrypt) public AjaxResult testDecrypt(RequestBody MapString, String params) { try { String cipherText params.get(cipherText); String decryptedText sm2Service.decrypt(cipherText); return AjaxResult.success(解密成功, decryptedText); } catch (Exception e) { return AjaxResult.error(解密失败: e.getMessage()); } } }这样你可以先用已知的明文如test123和前端公钥在浏览器控制台用sm-crypto加密得到密文。然后将这个密文通过Postman发给这个/test/sm2/decrypt接口看后端是否能正确解密回test123。这个“单元测试”能快速定位是加解密算法本身的问题还是集成到登录流程中的问题。整个整合过程从技术上看并不复杂但细节决定成败尤其是前后端数据格式的约定、密钥的管理以及异常流的处理。希望这份详细的实践记录和踩坑经验能帮助你在若依框架中顺利落地国密SM2加密登录方案切实提升系统的安全性。