- 当前位置：首页 >应用开发 >聊聊 Sharding-JDBC 数据脱敏
聊聊 Sharding-JDBC 数据脱敏
发布时间：2025-11-04 19:16:52 来源：技术快报 作者：系统运维
安全控制一直是聊聊治理的重要环节，数据脱敏属于安全控制的数据范畴。对互联网公司、脱敏传统行业来说，聊聊数据安全一直是数据极为重视和敏感的话题。
数据脱敏是脱敏指对某些敏感信息通过脱敏规则进行数据的变形，实现敏感隐私数据的聊聊可靠保护。
涉及客户安全数据或者一些商业性敏感数据，数据如身份证号、脱敏手机号、聊聊卡号、数据客户号等个人信息按照相关部门规定，脱敏都需要进行数据脱敏。聊聊
今天来深入聊一下 Sharding-JDBC 如何对敏感数据脱敏，数据仅在持久层脱敏。脱敏
几个重要概念
Sharding-JDBC 在底层进行了脱敏的封装，让开发人员在无感知的情况下进行数据脱敏，来看一下官方的详情图，如下：
下面针对上图中涉及到的几个名词进行详细的解释，在下文实战中做个铺垫。
1. 数据源配置这个就是免费源码下载Datasource的配置。
2. 加密器配置加密器就涉及到数据脱敏了，Sharding-JDBC 内置了两个加密器，如下：
MD5Encryptor：MD5加密算法，一种不可逆的加密方式，通常用来对密码进行加密AESEncryptor：AES加密算法，一种可逆的加密方式，通常用来对回显的字段加密，比如身份证、手机号码Sharding-JDBC还支持自定义加密器。
3. 脱敏表配置用于告诉 Sharding-JDBC 数据表里哪个列用于存储密文数据(cipherColumn)、哪个列用于存储明文数据(plainColumn)以及用户想使用哪个列进行SQL编写(logicColumn)：
logicColumn：逻辑列，这个和前文中逻辑表类似，用于实际的SQL编写，比如数据库中真实字段是cipher_pwd，但是在Sharding-JDBC配置时指定逻辑列的名称为：pwd，那么在写SQL的时候就要使用逻辑列pwd进行查询。cipherColumn：存储密文数据的字段plainColumn：存储明文数据的字段，一般不使用，不然脱敏也毫无意义4. 查询属性的配置当底层数据库表里同时存储了明文数据、密文数据后，源码下载该属性开关用于决定是直接查询数据库表里的明文数据进行返回，还是查询密文数据通过Encrypt-JDBC解密后返回。
数据脱敏实战
基本概念介绍完了，下面就使用Sharding-JDBC进行数据脱敏。
这里就不再演示分库分表了，直接用单库进行脱敏演示。
1. 新建表笔者这里新建了一张用户表t_user，如下：
复制CREATE TABLE `t_user`(
`user_id` bigint(20) NOT NULL COMMENT 用户唯一ID,
`fullname` varchar(50) DEFAULT NULL COMMENT 名字,
`user_type` varchar(255) DEFAULT NULL COMMENT 类型,
`cipher_pwd` varchar(255) DEFAULT NULL COMMENT 密码,
`mobile` varchar(100) DEFAULT NULL COMMENT 手机号,
`mobile_data` varchar(100) DEFAULT NULL COMMENT 手机号,
`id_card` varchar(60) DEFAULT NULL COMMENT 身份证,
PRIMARY KEY (`user_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;1.2.3.4.5.6.7.8.9.10. 2. 数据源配置数据源这里使用单数据源，配置很简单，上篇文章也演示过，配置如下：
复制spring:
# Sharding-JDBC的配置 shardingsphere:
datasource:
names: ds # 数据源ds配置 ds:
type: com.alibaba.druid.pool.DruidDataSource driver-class-name: com.mysql.jdbc.Driver url: jdbc:mysql://localhost:3306/user_db?useUnicode=true&characterEncoding=utf-8 username: root password: 1234561.2.3.4.5.6.7.8.9.10.11.12. 3. 加密器声明需要用到什么加密器需要事先在配置文件中声明，这样才能在字段中去引用，配置如下：
复制spring:
encrypt:
encryptors:
# md5加密算法-sharding-jdbc内置的算法，这里名称任意 encryptor_md5:
# 别名，这里一定要是MD5 type: MD5 # aes加密算法-sharding-jdbc内置的算法，这里名称任意 encryptor_aes:
# 别名，这里一定要是aes type: aes props:
# 设置秘钥 aes.key.value: myjszl1.2.3.4.5.6.7.8.9.10.11.12.13.14.上述总计配置了两种Sharding-JDBC内置的加密器，如下：
encryptor_md5：MD5Encryptor加密器，这里的名称可以任意，但是type这个属性一定要是MD5encryptor_aes：AESEncryptor加密器，对称加密算法，亿华云计算因此需要指定加密的秘钥：aes.key.valueSharding-JDBC指定规则如下：
复制#加解密器类型，可自定义或选择内置类型：MD5/AESspring.shardingsphere.encrypt.encryptors.<encryptor-name>.type=#属性配置, 注意：使用AES加密器，需要配置AES加密器的KEY属性：aes.key.valuespring.shardingsphere.encrypt.encryptors.<encryptor-name>.props.<property-name>=1.2.3.4.5. 4. 对数据脱敏配置下面针对三个字段进行脱敏，如下：
cipher_pwd：密码使用不可逆的加密器MD5Encryptorid_card：身份证使用可逆的加密器AESEncryptormobile：手机号使用可逆的加密器AESEncryptor详细的配置如下：
复制spring:
# Sharding-JDBC的配置 shardingsphere:
encrypt:
tables:
t_user:
columns:
# 逻辑列，sharding-jdbc中写SQL需要用到的列 password:
# 存储明文的字段 #plainColumn: password # 存储密文的字段 cipherColumn: cipher_pwd # 指定加密器 encryptor: encryptor_md5 # 身份证号的逻辑列，使用aes这种可逆的加密算法 id_card:
cipherColumn: id_card encryptor: encryptor_aes # 手机号的逻辑列，使用aes这种可逆的加密算法 mobile:
cipherColumn: mobile encryptor: encryptor_aes1.2.3.4.5.6.7.8.9.10.11.12.13.14.15.16.17.18.19.20.21.22.23.Sharding-JDBC 指定的规则如下：
复制spring.shardingsphere.encrypt.tables.<table-name>.columns.<logic-column-name>.encryptor= #加密器名字spring.shardingsphere.encrypt.tables.<table-name>.columns.<logic-column-name>.plainColumn= #存储明文的字段spring.shardingsphere.encrypt.tables.<table-name>.columns.<logic-column-name>.cipherColumn= #存储密文的字段1.2.3.4.5.注意：上述配置中的密码这个字段，数据库表中的真实字段是cipher_pwd，但是这里笔者指定的逻辑列是password，因此在写SQL的时候，一定要写password这个逻辑列，比如查询的SQL，如下：
复制SELECT password AS cipherPwd,
fullname,
user_type,
id_card AS id_cardFROM t_user where user_id=?1.2.3.4.5.6.7.现在向其中插入几条数据看看效果，单元测试如下：
复制@Testpublic void testInsertUser() {
for (int i = 0; i < 10; i++) {
User user = new User();
user.setFullName("不才陈某");
user.setCipherPwd("abc123");
user.setIdCard("320829198708012232");
user.setUserId((long)i);
user.setMobile("13852331509");
userMapper.insertUser(user);
}
}1.2.3.4.5.6.7.8.9.10.11.12.数据如下：
可以看到数据持久化到数据库中已经脱敏了。
问题来了：那么查询的效果出来的效果是什么？
试想一下，MD5加密器是不可逆的，AES加密器是可逆的，那么符合正常逻辑的状态下就应该是密码这个字段查询出来的还是密文(不可逆)，身份证、手机号查询出来的应该是明文。
新建查询的单元测试，如下：
复制@Testpublic void testList() throws JsonProcessingException{
List<User> users = userMapper.listAll();
ObjectMapper objectMapper = new ObjectMapper();
String json = objectMapper.writeValueAsString(users);
System.out.println(json);
}1.2.3.4.5.6.7.结果如下：
很清楚了，一切都朝着我们的预料的方向发展~
限制条件
字段进行脱敏后在写SQL时有一些操作是不支持的，如下：
脱敏字段无法支持比较操作，如：大于小于、ORDER BY、BETWEEN、LIKE等。脱敏字段无法支持计算操作，如：AVG、SUM以及计算表达式 。原理
其实Sharding-JDBC数据脱敏原理很简单，看一下官方给的一张图：
加密器有一个公共的接口Encryptor，如下：
复制public interface Encryptor extends TypeBasedSPI{
/** * Initialize. */ void init();
/** * Encode. * * @param plaintext plaintext * @return ciphertext */ String encrypt(Object plaintext);
/** * Decode. * * @param ciphertext ciphertext * @return plaintext */ Object decrypt(String ciphertext);
}1.2.3.4.5.6.7.8.9.10.11.12.13.14.15.16.17.18.19.20.21.22.23.当插入数据涉及到加密字段，即是定义的逻辑列，那么Sharding-JDBC内部会将这条SQL改写，将逻辑列替换成表的真实列，并且调用 encrypt(Object plaintext)方法将明文加密成密文后存储进去。
2. 更新数据更新和插入数据一样，同样会将SQL改写，调用encrypt(Object plaintext)方法将明文加密成密文后存储进去。
3. 查询数据查询数据就比较复杂了，这里只讨论默认情况，则是使用加密列查询，默认配置如下：
复制spring.shardingsphere.props.query.with.cipher.column=true1.查询分为两类，如下：
(1) where条件中不带脱敏逻辑列
这种情况也就是在查询结果集中涉及到脱敏的逻辑列，但是在查询条件中不涉及，那么在返回结果的时候则会调用加密器的解密方法Object decrypt(String ciphertext)去将结果解密返回。
(2) where条件中带脱敏逻辑列
这种情况就比较复杂了，where条件中涉及了脱敏逻辑列，那么在改写SQL时会调用加密器的加密方法String encrypt(Object plaintext)将其加密成密文去查询；
同样返回结果集也会调用加密器的解密方法Object decrypt(String ciphertext)去将结果解密返回。
加密策略
Sharding-JDBC默认提供了两种内置的加密器，但是实际开发中这两种肯定是不够用的，需要开发人员去自定义加密器应该各种场景。
Sharding-JDBC提供了两类加密策略接口，如下：
1. Encryptor提供encrypt(), decrypt()两种方法对需要脱敏的数据进行加解密;在用户进行INSERT, DELETE, UPDATE时，ShardingSphere会按照用户配置，对SQL进行解析、改写、路由，并会调用encrypt()将数据加密后存储到数据库, 而在SELECT时，则调用decrypt()方法将从数据库中取出的脱敏数据进行逆向解密，最终将原始数据返回给用户。
接口如下：
复制public interface Encryptor extends TypeBasedSPI{
void init();
String encrypt(Object plaintext);
Object decrypt(String ciphertext);
}1.2.3.4.5. 2. QueryAssistedEncryptor相比较于第一种脱敏方案，该方案更为安全和复杂。它的理念是：即使是相同的数据，如两个用户的密码相同，它们在数据库里存储的脱敏数据也应当是不一样的。这种理念更有利于保护用户信息，防止撞库成功。
它提供三种函数进行实现，分别是encrypt(), decrypt(), queryAssistedEncrypt()。在encrypt()阶段，用户通过设置某个变动种子，例如时间戳。针对原始数据+变动种子组合的内容进行加密，就能保证即使原始数据相同，也因为有变动种子的存在，致使加密后的脱敏数据是不一样的。在decrypt()可依据之前规定的加密算法，利用种子数据进行解密。
虽然这种方式确实可以增加数据的保密性，但是另一个问题却随之出现：相同的数据在数据库里存储的内容是不一样的，那么当用户按照这个加密列进行等值查询(SELECT FROM table WHERE encryptedColumnn = ?)时会发现无法将所有相同的原始数据查询出来。
为此，我们提出了辅助查询列的概念。该辅助查询列通过queryAssistedEncrypt()生成，与decrypt()不同的是，该方法通过对原始数据进行另一种方式的加密，但是针对原始数据相同的数据，这种加密方式产生的加密数据是一致的。
将queryAssistedEncrypt()后的数据存储到数据中用于辅助查询真实数据。因此，数据库表中多出这一个辅助查询列。
由于queryAssistedEncrypt()和encrypt()产生不同加密数据进行存储，而decrypt()可逆，queryAssistedEncrypt()不可逆。在查询原始数据的时候，会自动对SQL进行解析、改写、路由，利用辅助查询列进行 WHERE条件的查询，却利用 decrypt()对encrypt()加密后的数据进行解密，并将原始数据返回给用户。这一切都是对用户透明化的。
简单概括一下：
QueryAssistedEncryptor更加安全，加了一个变动因子一起加密，这样即使内容一样加密后的密文也是不同的为了查询方便，提供了一个辅助查询列，这个辅助查询列中的数据不带变动因子，直接明文加密的，可以根据辅助查询列查询这一切的操作都是透明的，开发人员无须关心，只需要按照给定的规则配置接口如下：
复制public interface QueryAssistedEncryptor extends Encryptor{
String queryAssistedEncrypt(String plaintext);
}
1.2.3.QueryAssistedEncryptor这类加密策略并无内置的加密器，需要开发人员自定义实现。
如何自定义加密器
上文介绍到了Sharding-JDBC支持的两种加密策略，肯定都是要实现一下，下面将会针对两种策略去介绍一下如何自定义。
1. Encryptor 自定义实现自定义很简单，直接实现Encryptor 接口即可，重写其中的加密、解密方法。
下面自定义一个SHA256加密算法器，这是一种不可逆的算法，如下：
复制/** * @author 不才陈某 公众号：码猿技术专栏 * 自定义的加密解密算法，基于sha256 */@Datapublic class Sha256HexEncryptor implements Encryptor{
/** * 别名，配置时需要 */ public final static String ALGORITHM_NAME="SHA256";
private Properties properties = new Properties();
@Override public void init() {
}
/** * 加密 * INSERT, DELETE, UPDATE时会调用该方法进行加密存储到数据库中 * @param plaintext 明文 * @return 加密后的密文 */ @Override public String encrypt(final Object plaintext) {
if (null == plaintext) {
return null;
}
return DigestUtils.sha256Hex(String.valueOf(plaintext));
}
/** * 解密 * 在SELECT 查询会调用该方法进行解密 * @param ciphertext 密文 * @return 由于sha256是一种不可逆的算法，因此直接返回密文 */ @Override public String decrypt(final String ciphertext) {
return ciphertext;
}
/** * 别名，在配置中指定的名称 */ @Override public String getType() {
return Sha256HexEncryptor.ALGORITHM_NAME;
}
}1.2.3.4.5.6.7.8.9.10.11.12.13.14.15.16.17.18.19.20.21.22.23.24.25.26.27.28.29.30.31.32.33.34.35.36.37.38.39.40.41.42.43.44.45.46.47.48.49.50.51.52.加密解密的过程和MD5Encryptor加密器类似，不再详细介绍了，很容易理解。
由于是使用SPI的方式，因此还需要在resource/META-INF/services目录中新建一个org.apache.shardingsphere.encrypt.strategy.spi.Encryptor文件，内容如下：
复制com.java.family.shardingjdbc003.encryptor.Sha256HexEncryptor1.好了，现在这个SHA256加密器就已经定义好了，可以在配置文件中配置了。
现在使用自定义SHA256加密器对密码这个列进行加密，分为如下步骤：
(1) 声明加密器
声明很简单，配置如下：
复制spring:
# Sharding-JDBC的配置 shardingsphere:
encrypt:
encryptors:
# sha256加密算法，自定义的 encryptor_sha256:
type: SHA2561.2.3.4.5.6.7.8.(2) 逻辑列配置加密器
只需要将加密器的名字改成上面声明的encryptor_sha256即可，配置如下：
复制spring:
# Sharding-JDBC的配置 shardingsphere:
encrypt:
tables:
t_user:
columns:
# 逻辑列，sharding-jdbc中写SQL需要用到的列 password:
# 存储明文的字段 #plainColumn: password # 存储密文的字段 cipherColumn: cipher_pwd # 指定加密器 encryptor: encryptor_sha2561.2.3.4.5.6.7.8.9.10.11.12.13.14.15.至此，配置成功了，自己去演示看一下吧，这里就不再细说了。
2. QueryAssistedEncryptor 自定义实现下面通过Base64加密算法自定义实现一个QueryAssistedEncryptor加密器，如下：
复制/** * @author 不才陈某 公众号：码猿技术专栏 * 自定义QueryAssistedEncryptor加密器 */@Datapublic class Base64AssistedEncryptor implements QueryAssistedEncryptor{
/** * 别名，配置时需要 */ public final static String ALGORITHM_NAME="Base64_Assisted";
private Properties properties = new Properties();
/** * 辅助查询列的加密方法 */ @Override public String queryAssistedEncrypt(String plaintext) {
if (null == plaintext) {
return null;
}
return Base64.encode(plaintext);
}
@Override public void init() {
}
/** * 加密方法 * 使用时间戳作为变动因子 */ @Override public String encrypt(final Object plaintext) {
if (null == plaintext) {
return null;
}
//获取时间戳作为变动因子 String randomFactor =String.valueOf( new Date().getTime());
return Base64.encode(plaintext+"_"+randomFactor);
}
/** * 解密方法 * Base64是一个可逆的加密算法，因此可以对密文进行解密并且剔除变动因子则为明文 */ @SneakyThrows @Override public Object decrypt(final String ciphertext) {
if (null == ciphertext) {
return null;
}
return new String(Base64.decode(ciphertext),"UTF-8").split("_")[0];
}
@Override public String getType() {
return ALGORITHM_NAME;
}
}1.2.3.4.5.6.7.8.9.10.11.12.13.14.15.16.17.18.19.20.21.22.23.24.25.26.27.28.29.30.31.32.33.34.35.36.37.38.39.40.41.42.43.44.45.46.47.48.49.50.51.52.53.54.55.56.57.58.59.60.61.62.需要注意以下两点：
queryAssistedEncrypt()：该方法在插入、更新逻辑列设置辅助查询列值、逻辑列作为where查询条件时会被调用对辅助查询列加密decrypt()：这里的Base64是可逆的加密算法，因此只需要对其解密，并且剔除变动因子则为明文同样的也需要在resource/META-INF/services目录中新建一个org.apache.shardingsphere.encrypt.strategy.spi.Encryptor文件，内容如下：
复制com.java.family.shardingjdbc003.encryptor.Base64AssistedEncryptor1.配置也很简单，同样分为两步，如下：
(1) 声明加密器
配置如下：
复制spring:
# Sharding-JDBC的配置 shardingsphere:
encrypt:
encryptors:
# Base64加密算法，自定义的 encryptor_base64_assisted:
type: Base64_Assisted1.2.3.4.5.6.7.8.(2) 逻辑列配置加密器
只需要将加密器的名字改成上面声明的encryptor_base64_assisted即可，配置如下：
复制spring: # Sharding-JDBC的配置 shardingsphere:
encrypt:
tables:
t_user:
columns:
# 逻辑列，sharding-jdbc中写SQL需要用到的列 mobile:
# 密文存储的列 cipherColumn: mobile # 辅助查询列，表中真实的字段名 assistedQueryColumn: mobile_data encryptor: encryptor_base64_assisted1.2.3.4.5.6.7.8.9.10.11.12.13.14.唯一不同的就是多了一个assistedQueryColumn辅助查询列的配置。
好了，上述配置好了以后就可以进行单元测试了，插入数据结果：
可以看到mobile这个字段的值都是不同的，但是mobile_data这个辅助查询列都是相同的，因为辅助查询列并未使用变动因子进行加密。
关于查询如果涉及到mobile的条件查询，那么将会调用queryAssistedEncrypt()方法加密后根据辅助查询mobile_data列进行查询，SQL如下图：
- Copyright © 2025 Powered by 聊聊 Sharding-JDBC 数据脱敏,技术快报 滇ICP备2023006006号-46sitemap