2025.4.14
SpringBoot集成AES加密的完整指南
AES(Advanced Encryption Standard)是一种对称加密算法，是目前最常用的加密方式之一，广泛应用于保护敏感数据如密码、信用卡信息等。在SpringBoot项目中集成AES加密可以有效提升数据传输和存储的安全性。下面我将详细介绍几种在SpringBoot中实现AES加密的方案。
一、AES加密基础
AES是一种对称加密算法，加密和解密使用相同的密钥。它的特点包括：
- 安全性高：AES被广泛认为是目前最安全的对称加密算法之一
- 效率高：相比非对称加密算法(如RSA)，AES的计算速度更快
- 密钥长度：支持128位、192位和256位密钥长度，通常128位(16字节)即可满足大多数场景
二、SpringBoot集成AES加密的几种方案
方案1：基础工具类实现
这是最直接的实现方式，创建一个AES加密工具类：
import javax.crypto.Cipher;
import javax.crypto.spec.SecretKeySpec;
import java.util.Base64;
public class AesEncryptUtils {
private static final String KEY = "1234567890123456"; // 16位密钥
private static final String ALGORITHMSTR = "AES/ECB/PKCS5Padding";
public static String encrypt(String content) throws Exception {
Cipher cipher = Cipher.getInstance(ALGORITHMSTR);
cipher.init(Cipher.ENCRYPT_MODE, new SecretKeySpec(KEY.getBytes(), "AES"));
byte[] encrypted = cipher.doFinal(content.getBytes("utf-8"));
return Base64.getEncoder().encodeToString(encrypted);
}
public static String decrypt(String encryptStr) throws Exception {
Cipher cipher = Cipher.getInstance(ALGORITHMSTR);
cipher.init(Cipher.DECRYPT_MODE, new SecretKeySpec(KEY.getBytes(), "AES"));
byte[] encryptBytes = Base64.getDecoder().decode(encryptStr);
byte[] decryptBytes = cipher.doFinal(encryptBytes);
return new String(decryptBytes);
}
}
使用示例：
String content = "需要加密的数据";
String encrypt = AesEncryptUtils.encrypt(content); // 加密
String decrypt = AesEncryptUtils.decrypt(encrypt); // 解密
方案2：结合Spring MVC的全局加解密
通过实现RequestBodyAdvice和ResponseBodyAdvice接口，可以实现请求参数的自动解密和响应数据的自动加密：
- 创建自定义注解
@SecurityParameter：
@Target({ElementType.METHOD, ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
public @interface SecurityParameter {
boolean inDecode() default true; // 入参是否解密
boolean outEncode() default true; // 出参是否加密
}
- 实现请求解密拦截器：
@ControllerAdvice
public class DecodeRequestBodyAdvice implements RequestBodyAdvice {
@Override
public HttpInputMessage beforeBodyRead(HttpInputMessage inputMessage, MethodParameter parameter,
Type targetType, Class<? extends HttpMessageConverter<?>> converterType) throws IOException {
// 解密逻辑
String httpBody = decryptBody(inputMessage);
return new SecretHttpMessage(new ByteArrayInputStream(httpBody.getBytes()), inputMessage.getHeaders());
}
// 其他必要方法...
}
- 实现响应加密拦截器：
@ControllerAdvice
public class EncodeResponseBodyAdvice implements ResponseBodyAdvice<Object> {
@Override
public Object beforeBodyWrite(Object body, MethodParameter returnType,
MediaType selectedContentType, Class<? extends HttpMessageConverter<?>> selectedConverterType,
ServerHttpRequest request, ServerHttpResponse response) {
// 加密逻辑
return encrypt(body);
}
// 其他必要方法...
}
方案3：使用现有加密框架
可以使用现有的加密框架如encryption-spring-boot-starter，简化集成：
- 添加依赖：
<dependency>
<groupId>com.github.xzb617</groupId>
<artifactId>encryption-spring-boot-starter</artifactId>
<version>1.0.1</version>
</dependency>
- 配置application.yml：
encryption:
charset: 'UTF-8'
algorithm: aes
configs:
secret: 'your-secret-key-here'
iv: 'initialization-vector'
- 在启动类添加注解：
@EnableEncryption
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
- 在Controller中使用：
@GetMapping("/test")
public Result test(@DecryptParam String param) {
// 参数会自动解密
return Result.success("操作成功");
}
三、AES加密模式选择
AES有多种加密模式，常见的有：
- ECB模式：最简单的模式，每个块独立加密，安全性较低
- CBC模式：需要初始化向量(IV)，安全性高于ECB
- 其他模式：如CFB、OFB、CTR等
推荐使用CBC模式，示例代码：
public class AesCbcUtil {
private static final String IV = "1234567890123456"; // 16位初始化向量
public static String encrypt(String content, String key) throws Exception {
Cipher cipher = Cipher.getInstance("AES/CBC/PKCS5Padding");
IvParameterSpec ivSpec = new IvParameterSpec(IV.getBytes());
cipher.init(Cipher.ENCRYPT_MODE, new SecretKeySpec(key.getBytes(), "AES"), ivSpec);
byte[] encrypted = cipher.doFinal(content.getBytes(StandardCharsets.UTF_8));
return Base64.getEncoder().encodeToString(encrypted);
}
public static String decrypt(String content, String key) throws Exception {
Cipher cipher = Cipher.getInstance("AES/CBC/PKCS5Padding");
IvParameterSpec ivSpec = new IvParameterSpec(IV.getBytes());
cipher.init(Cipher.DECRYPT_MODE, new SecretKeySpec(key.getBytes(), "AES"), ivSpec);
byte[] encrypted = Base64.getDecoder().decode(content);
byte[] original = cipher.doFinal(encrypted);
return new String(original, StandardCharsets.UTF_8);
}
}
四、前后端协同加解密
在实际项目中，通常需要前后端协同实现加解密：
前端加密示例(JavaScript)
// 使用crypto-js库
const CryptoJS = require('crypto-js');
const key = CryptoJS.enc.Utf8.parse('1234567890123456'); // 16字节密钥
const iv = CryptoJS.enc.Utf8.parse('1234567890123456'); // 16字节IV
// 加密
function encrypt(data) {
return CryptoJS.AES.encrypt(data, key, {
iv: iv,
mode: CryptoJS.mode.CBC,
padding: CryptoJS.pad.Pkcs7
}).toString();
}
// 解密
function decrypt(encrypted) {
return CryptoJS.AES.decrypt(encrypted, key, {
iv: iv,
mode: CryptoJS.mode.CBC,
padding: CryptoJS.pad.Pkcs7
}).toString(CryptoJS.enc.Utf8);
}
后端解密处理
@RestController
@RequestMapping("/api")
public class ApiController {
@PostMapping("/data")
public ResponseEntity<?> handleData(@RequestBody EncryptedData data) {
try {
String decrypted = AesUtil.decrypt(data.getContent());
// 处理业务逻辑...
return ResponseEntity.ok("处理成功");
} catch (Exception e) {
return ResponseEntity.badRequest().body("解密失败");
}
}
}
五、密钥管理最佳实践
- 不要硬编码密钥：将密钥存储在配置文件中或配置中心
- 使用环境变量：敏感信息如密钥可以通过环境变量注入
- 定期更换密钥：特别是当怀疑密钥可能泄露时
- 不同环境使用不同密钥：开发、测试、生产环境应使用不同密钥
application.yml配置示例：
app:
aes:
key: ${AES_KEY:default-key-123456} # 优先使用环境变量AES_KEY
iv: ${AES_IV:default-iv-123456}
六、性能优化建议
- 重用Cipher实例：Cipher初始化开销较大，可以考虑缓存实例
- 选择合适的填充模式：PKCS5Padding/PKCS7Padding是常用选择
- 批量处理数据：对大块数据加密时，考虑分块处理
- 异步处理：加解密操作可以放在异步线程中执行，避免阻塞主线程
七、常见问题解决
- InvalidKeyException：通常是因为密钥长度不符合要求，确保使用16/24/32字节的密钥
- BadPaddingException：加密和解密使用的填充模式不一致导致
- IllegalBlockSizeException：数据长度不符合块大小要求，确保使用正确的填充模式
- 跨语言加解密问题：确保前后端使用相同的加密模式、填充模式和密钥
总结
在SpringBoot中集成AES加密有多种方式，从简单的工具类到完整的框架集成，开发者可以根据项目需求选择适合的方案。关键是要确保加密算法的正确实现、密钥的安全管理以及前后端的协同一致。通过合理的加密实现，可以显著提高应用程序的数据安全性。
对于更复杂的需求，可以考虑使用专业的加密库或框架，如Bouncy Castle等，它们提供了更多高级功能和算法支持。
浙公网安备 33010602011771号