mybatis-plus实现数据字段加解密

### MyBatis-Plus 敏感字段加密实现方法 #### 一、引入必要的依赖 为了在 MyBatis-Plus 中实现敏感字段的加密，首先需要确保项目中包含了 AES 加密所需的依赖。通常情况下，在 `pom.xml` 文件中添加如下依赖即可[^2]。 ```xml <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-security</artifactId> </dependency> <!-- 如果使用的是非 Spring Boot 项目，则需单独加入 BouncyCastle 或其他支持 AES 的库 --> <dependency> <groupId>org.bouncycastle</groupId> <artifactId>bcprov-jdk15on</artifactId> <version>最新版本号</version> </dependency> ``` #### 二、创建加解密工具类 定义一个用于执行实际加解密工作的工具类，该类负责提供统一接口来完成对指定字符串类型的敏感数据进行加密和解密操作。下面是一个简单的例子： ```java import javax.crypto.Cipher; import javax.crypto.KeyGenerator; import javax.crypto.SecretKey; import javax.crypto.spec.SecretKeySpec; import java.util.Base64; public class AesUtil { private static final String ALGORITHM = "AES"; public static SecretKey generateKey() throws Exception { KeyGenerator keyGen = KeyGenerator.getInstance(ALGORITHM); keyGen.init(128); // 可选参数长度为128, 192或256位 return keyGen.generateKey(); } public static byte[] encrypt(String content, SecretKey secretKey) throws Exception { Cipher cipher = Cipher.getInstance(ALGORITHM); cipher.init(Cipher.ENCRYPT_MODE, secretKey); return Base64.getEncoder().encode(cipher.doFinal(content.getBytes())); } public static String decrypt(byte[] encryptedContent, SecretKey secretKey) throws Exception { Cipher cipher = Cipher.getInstance(ALGORITHM); cipher.init(Cipher.DECRYPT_MODE, secretKey); return new String(cipher.doFinal(Base64.getDecoder().decode(encryptedContent))); } } ``` #### 三、自定义插件拦截器 通过继承 `AbstractSqlInjector` 类并重写其中的方法来自定义 SQL 注入逻辑，从而可以在每次插入/更新记录前自动调用上述工具类来进行加密处理；而在查询时则相反地先解码再返回给业务层消费。具体做法是在项目的启动类上注册此插件实例[^3]。 ```java @Component @Intercepts({ @Signature(type = Executor.class, method = "update", args = {MappedStatement.class, Object.class}), @Signature(type = Executor.class, method = "query", args = {MappedStatement.class, Object.class, RowBounds.class, ResultHandler.class}) }) public class EncryptInterceptor extends AbstractSqlInjector implements Interceptor { @Override protected void injectMap(MappedStatement ms, Class<?> mapperClass, Method method, Object... params) throws Throwable { super.injectMap(ms, mapperClass, method, params); MetaObject metaObject = SystemMetaObject.forObject(params[0]); if (metaObject.hasGetter("sensitiveData")){ // 判断是否存在名为'sensitiveData'属性 String originalValue = (String) metaObject.getValue("sensitiveData"); try{ SecretKey secretKey = AesUtil.generateKey(); // 获取秘钥对象 if ("insert".equals(method.getName()) || "updateById".equals(method.getName())) { byte[] encryptedBytes = AesUtil.encrypt(originalValue, secretKey); metaObject.setValue("sensitiveData", encryptedBytes); }else if("selectOne".equals(method.getName())){ String decryptedStr=AesUtil.decrypt((byte[])originalValue,secretKey ); metaObject.setValue("sensitiveData",decryptedStr ); } }catch(Exception e){ throw new RuntimeException(e.getMessage(),e.getCause()); } } } } ``` 以上就是关于如何利用 MyBatis-Plus 结合 Java 内置的安全机制（如 JCE）以及第三方安全组件（比如 BC 库），轻松达成数据库层面的数据保护目标的整体思路介绍[^1]。