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

别再手动加密了！用RuoYi-Vue-Plus的Encrypt组件，5分钟搞定Mybatis数据自动加解密

news 2026/5/26 7:51:12

告别手动加密时代：RuoYi-Vue-Plus Encrypt组件全自动数据保护实战

在当今数据安全日益受到重视的背景下，开发者们经常需要处理用户敏感信息的存储问题。传统的手动加密方式不仅增加了代码复杂度，还容易因疏忽导致数据泄露风险。RuoYi-Vue-Plus框架的Encrypt组件正是为解决这一痛点而生，它通过Mybatis拦截器机制实现了声明式的数据自动加解密，让开发者能够专注于业务逻辑而非安全细节。

1. 为什么需要自动加解密方案

在常规Java后端开发中，处理敏感数据加密通常意味着在Service层手动调用加密工具类。这种模式存在几个明显缺陷：

代码侵入性强：加解密逻辑散落在业务代码各处
维护成本高：加密算法变更需要修改多处调用点
易出错：开发人员可能忘记调用加密方法
可读性差：业务逻辑与安全逻辑混杂

// 传统手动加密方式示例 public void saveUser(User user) { // 业务逻辑... user.setPhone(EncryptUtils.encrypt(user.getPhone())); user.setIdCard(EncryptUtils.encrypt(user.getIdCard())); userMapper.insert(user); // 更多业务逻辑... }

相比之下，RuoYi-Vue-Plus的Encrypt组件提供了一种基于注解的声明式解决方案：

public class User { @EncryptField private String phone; @EncryptField(algorithm = AlgorithmType.AES, encode = EncodeType.HEX) private String idCard; // 其他字段... }

2. Encrypt组件核心架构解析

2.1 技术实现原理

Encrypt组件通过Mybatis插件机制在SQL执行前后自动处理数据加解密，主要涉及两个关键拦截器：

拦截器类型	拦截时机	处理目标	对应类名
参数加密拦截器	SQL执行前	预处理语句参数	MybatisEncryptInterceptor
结果解密拦截器	SQL执行后	查询结果集	MybatisDecryptInterceptor

组件采用经典的拦截器设计模式，核心处理流程包括：

识别带有@EncryptField注解的字段
根据配置选择合适的加密算法
在数据持久化前自动加密
在数据查询后自动解密

2.2 加密算法支持

组件内置了多种加密算法和编码方式，可通过注解参数灵活配置：

支持的算法类型(AlgorithmType)：

BASE64
AES
RSA
SM4（国密算法）

支持的编码方式(EncodeType)：

BASE64
HEX
NONE（原始字节）

3. 五分钟快速集成指南

3.1 环境准备

确保项目已集成以下依赖：

RuoYi-Vue-Plus 5.X+
Mybatis 3.5+
Spring Boot 2.7+

3.2 配置步骤

添加Maven依赖：

<dependency> <groupId>com.ruoyi</groupId> <artifactId>ruoyi-encrypt</artifactId> <version>${ruoyi.version}</version> </dependency>

配置application.yml：

ruoyi: encrypt: enabled: true default-algorithm: AES default-encode: BASE64 aes-key: 你的AES密钥(16/24/32字节)

实体类标注加密字段：

public class Employee { @EncryptField // 使用默认算法配置 private String bankAccount; @EncryptField(algorithm = AlgorithmType.SM4, encode = EncodeType.HEX) private String socialSecurityNumber; }

3.3 验证配置

编写测试用例验证加解密效果：

@SpringBootTest public class EncryptTest { @Autowired private EmployeeMapper employeeMapper; @Test public void testEncryptDecrypt() { Employee emp = new Employee(); emp.setBankAccount("6225880123456789"); emp.setSocialSecurityNumber("110101199003077832"); employeeMapper.insert(emp); Employee dbEmp = employeeMapper.selectById(emp.getId()); Assert.assertEquals(emp.getBankAccount(), dbEmp.getBankAccount()); Assert.assertEquals(emp.getSocialSecurityNumber(), dbEmp.getSocialSecurityNumber()); } }

4. 高级配置与自定义扩展

4.1 多算法混合使用

在实际项目中，不同敏感字段可能需要不同级别的加密保护：

public class MedicalRecord { @EncryptField(algorithm = AlgorithmType.AES) private String patientId; @EncryptField(algorithm = AlgorithmType.RSA) private String diagnosisInfo; @EncryptField(algorithm = AlgorithmType.SM4) private String treatmentHistory; }

4.2 自定义加密算法

当内置算法不满足需求时，可轻松扩展：

实现IEncryptor接口：

public class CustomEncryptor implements IEncryptor { @Override public String encrypt(EncryptContext context) { // 自定义加密逻辑 } @Override public String decrypt(EncryptContext context) { // 自定义解密逻辑 } }

注册自定义加密器：

@Configuration public class EncryptConfig { @Bean public IEncryptor customEncryptor() { return new CustomEncryptor(); } }

使用自定义算法：

public class ConfigEntity { @EncryptField(algorithm = AlgorithmType.CUSTOM, encryptor = "customEncryptor") private String secretConfig; }

4.3 性能优化建议

对于高并发场景，可考虑以下优化措施：

缓存加密器实例：避免每次加解密都创建新实例
批量操作优化：对批量插入/查询进行特殊处理
异步加解密：对非实时性要求的数据可采用异步处理

// 批量加密优化示例 public class BatchEncryptHandler { private final IEncryptor encryptor; public List<String> batchEncrypt(List<String> dataList) { return dataList.parallelStream() .map(data -> encryptor.encrypt(data)) .collect(Collectors.toList()); } }