当前位置：首页 > news >正文

Spring Boot项目实战：5分钟搞定国密SM2加解密，附完整Java代码和BouncyCastle依赖

news 2026/6/11 6:00:48

Spring Boot实战：国密SM2加解密快速集成指南

在金融、政务等对数据安全要求严格的领域，国密算法正逐渐成为标配。作为国内自主研发的密码体系，SM2算法凭借其高安全性和高效能，正在替代传统的RSA算法。本文将带你快速在Spring Boot项目中集成SM2加解密功能，从环境配置到API封装，5分钟实现核心功能。

1. 环境准备与依赖配置

1.1 BouncyCastle安全提供者

SM2算法的实现需要BouncyCastle库的支持。在Spring Boot项目中，首先需要在pom.xml中添加以下依赖：

<dependency> <groupId>org.bouncycastle</groupId> <artifactId>bcprov-jdk15to18</artifactId> <version>1.71</version> </dependency>

然后，我们需要在应用启动时注册BouncyCastle安全提供者。这可以通过创建一个配置类来实现：

@Configuration public class CryptoConfig { @PostConstruct public void init() { Security.addProvider(new BouncyCastleProvider()); } }

1.2 密钥管理策略

在实际项目中，我们通常有以下几种密钥管理方式：

配置文件存储：适合开发环境，将公钥/私钥直接写在配置文件中
环境变量注入：更安全的方式，通过CI/CD流程注入
密钥管理系统：生产环境推荐，如使用Vault等专业密钥管理工具

这里我们采用配置文件方式，在application.yml中添加：

sm2: public-key: "04..." private-key: "..."

2. SM2工具类封装

2.1 密钥对生成

首先实现密钥对生成功能，这是SM2加解密的基础：

public class SM2Util { private static final String ALGORITHM_NAME = "EC"; private static final String CURVE_NAME = "sm2p256v1"; public static KeyPair generateKeyPair() throws Exception { KeyPairGenerator keyPairGenerator = KeyPairGenerator.getInstance( ALGORITHM_NAME, new BouncyCastleProvider() ); ECGenParameterSpec ecSpec = new ECGenParameterSpec(CURVE_NAME); keyPairGenerator.initialize(ecSpec, new SecureRandom()); return keyPairGenerator.generateKeyPair(); } }

2.2 加解密核心实现

SM2的加密过程相对复杂，需要处理椭圆曲线参数和不同的加密模式：

public static String encrypt(String publicKeyHex, String plainText) throws Exception { BCECPublicKey publicKey = getPublicKeyFromHex(publicKeyHex); SM2Engine engine = new SM2Engine(SM2Engine.Mode.C1C3C2); ECPublicKeyParameters keyParameters = getPublicKeyParameters(publicKey); engine.init(true, new ParametersWithRandom(keyParameters, new SecureRandom())); byte[] input = plainText.getBytes(StandardCharsets.UTF_8); byte[] encrypted = engine.processBlock(input, 0, input.length); return Hex.toHexString(encrypted); } public static String decrypt(String privateKeyHex, String cipherText) throws Exception { BCECPrivateKey privateKey = getPrivateKeyFromHex(privateKeyHex); SM2Engine engine = new SM2Engine(SM2Engine.Mode.C1C3C2); ECPrivateKeyParameters keyParameters = getPrivateKeyParameters(privateKey); engine.init(false, keyParameters); byte[] encrypted = Hex.decode(cipherText); byte[] decrypted = engine.processBlock(encrypted, 0, encrypted.length); return new String(decrypted, StandardCharsets.UTF_8); }

3. Spring Boot集成实践

3.1 自动配置与属性绑定

为了让工具类更易于使用，我们可以创建一个自动配置类：

@Configuration @ConfigurationProperties(prefix = "sm2") public class SM2AutoConfiguration { private String publicKey; private String privateKey; @Bean public SM2Service sm2Service() { return new SM2ServiceImpl(publicKey, privateKey); } // getters and setters }

3.2 REST API示例

下面是一个简单的API示例，展示如何在控制器中使用SM2加解密：

@RestController @RequestMapping("/api/crypto") public class CryptoController { @Autowired private SM2Service sm2Service; @PostMapping("/encrypt") public ResponseEntity<String> encrypt(@RequestBody String data) { try { String encrypted = sm2Service.encrypt(data); return ResponseEntity.ok(encrypted); } catch (Exception e) { return ResponseEntity.status(500).body("加密失败"); } } @PostMapping("/decrypt") public ResponseEntity<String> decrypt(@RequestBody String data) { try { String decrypted = sm2Service.decrypt(data); return ResponseEntity.ok(decrypted); } catch (Exception e) { return ResponseEntity.status(500).body("解密失败"); } } }

4. 性能优化与生产实践

4.1 密钥缓存策略

频繁创建密钥参数对象会影响性能，我们可以使用静态缓存：

private static final Map<String, ECDomainParameters> PARAM_CACHE = new ConcurrentHashMap<>(); private static ECDomainParameters getDomainParameters(ECParameterSpec spec) { return PARAM_CACHE.computeIfAbsent("sm2p256v1", k -> new ECDomainParameters(spec.getCurve(), spec.getG(), spec.getN()) ); }

4.2 异常处理最佳实践

SM2加解密可能遇到的各种异常及处理建议：

异常类型	可能原因	解决方案
InvalidKeyException	密钥格式错误	检查密钥是否完整且未损坏
IllegalStateException	未初始化BouncyCastle	确保安全提供者已注册
ArrayIndexOutOfBoundsException	密文格式错误	验证密文是否完整