1. Spring Boot注解实现信息脱敏的核心价值
最近在开发金融类项目时，遇到了一个典型需求：接口返回的敏感数据（如身份证号、银行卡号、手机号）需要在前端展示时进行部分隐藏处理。传统做法是在每个DTO字段上手动编写掩码逻辑，但这样会导致代码重复且难以维护。通过Spring Boot的注解机制，我们能够以声明式的方式实现统一脱敏，这正是现代Java开发追求的优雅解决方案。
信息脱敏本质上是在数据展示层对原始内容进行变形处理，既保证业务功能完整，又符合隐私保护要求。常见的脱敏规则包括：
- 手机号：138****1234
- 身份证号：110***********123X
- 银行卡号：6222 **** **** 4567
2. 核心实现方案设计
2.1 自定义脱敏注解开发
首先我们需要定义一套注解体系来描述脱敏规则。创建一个@Sensitive元注解作为基础：
java复制@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.FIELD)
public @interface Sensitive {
SensitiveType type() default SensitiveType.DEFAULT;
}
public enum SensitiveType {
ID_CARD, // 身份证
PHONE, // 手机号
BANK_CARD // 银行卡
}
2.2 序列化器实现方案
通过Jackson的@JsonSerialize注解指定自定义序列化器是实现脱敏的关键。创建SensitiveSerializer：
java复制public class SensitiveSerializer extends JsonSerializer<String> {
private final SensitiveType type;
public SensitiveSerializer(SensitiveType type) {
this.type = type;
}
@Override
public void serialize(String value, JsonGenerator gen,
SerializerProvider provider) {
try {
gen.writeString(processValue(value));
} catch (Exception e) {
gen.writeString(value); // 脱敏失败返回原值
}
}
private String processValue(String value) {
switch(type) {
case ID_CARD:
return value.replaceAll("(\\d{4})\\d{10}(\\w{1})", "$1**********$2");
case PHONE:
return value.replaceAll("(\\d{3})\\d{4}(\\d{4})", "$1****$2");
case BANK_CARD:
return value.replaceAll("(\\d{4})\\d{8}(\\d{4})", "$1****$2");
default:
return value;
}
}
}
2.3 DTO层应用示例
在实体类中应用注解的典型方式：
java复制public class UserDTO {
@Sensitive(type = SensitiveType.PHONE)
@JsonSerialize(using = SensitiveSerializer.class)
private String mobile;
@Sensitive(type = SensitiveType.ID_CARD)
@JsonSerialize(using = SensitiveSerializer.class)
private String idCard;
// getters & setters
}
3. 高级实现技巧与优化
3.1 基于AOP的Controller层统一处理
对于不想污染DTO的场景，可以通过AOP在Controller返回前拦截处理：
java复制@Aspect
@Component
public class SensitiveAspect {
@Around("@annotation(org.springframework.web.bind.annotation.ResponseBody)")
public Object processSensitiveData(ProceedingJoinPoint pjp) {
Object result = pjp.proceed();
if (result instanceof BaseResponse) {
((BaseResponse) result).getData().ifPresent(this::processFields);
}
return result;
}
private void processFields(Object obj) {
// 反射处理带有@Sensitive注解的字段
}
}
3.2 正则表达式优化技巧
不同业务场景可能需要不同的脱敏规则，建议将正则表达式配置化：
yaml复制sensitive:
patterns:
id-card: "(\\d{4})\\d{10}(\\w{1})"
phone: "(\\d{3})\\d{4}(\\d{4})"
bank-card: "(\\d{4})\\d{8}(\\d{4})"
通过@ConfigurationProperties加载配置，使规则可动态调整。
3.3 性能优化方案
大量使用反射会影响性能，可以通过预编译正则和缓存Field信息来优化：
java复制private static final Map<Field, Pattern> CACHE = new ConcurrentHashMap<>();
private Pattern getPattern(Field field) {
return CACHE.computeIfAbsent(field, f -> {
Sensitive anno = f.getAnnotation(Sensitive.class);
String regex = getRegexFromConfig(anno.type());
return Pattern.compile(regex);
});
}
4. 生产环境注意事项
4.1 日志系统的脱敏处理
很多开发者会忽略日志中的敏感信息。建议通过Logback/Layout的Converter实现：
xml复制<conversionRule name="sensitive"
converterClass="com.util.SensitiveLogConverter"/>
<pattern>%d %-5p [%c] %m{sensitive}%n</pattern>
4.2 深度拷贝问题
使用Hibernate等ORM框架时，注意实体对象脱敏可能影响数据库数据。推荐做法：
java复制@Transactional
public UserDTO getUser(Long id) {
User user = userRepository.findById(id);
return sensitiveMapper.map(user); // 使用MapStruct专门映射
}
4.3 国际化支持
不同国家的手机号、身份证格式不同，需要动态适配：
java复制public String maskPhone(String phone, Locale locale) {
PhoneFormat format = formatRegistry.getFormat(locale);
return format.mask(phone);
}
5. 常见问题排查指南
5.1 注解不生效的排查步骤
- 检查Jackson版本是否≥2.9（旧版对注解支持不完善）
- 确认字段没有同时被
@JsonIgnore等注解影响 - 调试
SensitiveSerializer的serialize方法是否被调用
5.2 特殊字符处理问题
遇到含中文或特殊符号的值时，建议：
java复制// 在正则中添加unicode支持
Pattern.compile("([\\u4e00-\\u9fa5]{1})[\\u4e00-\\u9fa5]+",
Pattern.UNICODE_CHARACTER_CLASS);
5.3 与Swagger/Knife4j的集成
在springdoc-openapi中展示脱敏后的示例：
java复制@Schema(example = "138****1234")
@Sensitive(type = SensitiveType.PHONE)
private String phone;
6. 扩展应用场景
6.1 配合MyBatis TypeHandler实现存储加密
java复制public class EncryptTypeHandler extends BaseTypeHandler<String> {
@Override
public void setNonNullParameter(PreparedStatement ps, int i,
String parameter, JdbcType jdbcType) {
ps.setString(i, AESUtil.encrypt(parameter));
}
//...其他方法实现解密
}
6.2 前端二次脱敏策略
即使后端已脱敏，前端仍可添加额外保护：
javascript复制const doubleMask = (str) => {
return str.replace(/[^*]/g, '*').substring(0, str.length);
}
6.3 审计日志的特殊处理
对于需要记录原始值的审计场景，可采用双字段设计：
java复制@Column(name = "real_phone")
private String realPhone; // 存储原始值
@Transient
@Sensitive(type = SensitiveType.PHONE)
private String displayPhone; // 展示用
在实际项目中，我们还将这套机制扩展到了员工邮箱、地址等字段的脱敏处理。一个比较实用的技巧是为不同安全级别设计不同的脱敏策略：
java复制public enum SecurityLevel {
LOW, // 仅隐藏部分
MEDIUM, // 隐藏更多字符
HIGH // 完全用*代替
}
通过组合注解@Sensitive(type=PHONE, level=HIGH)可以实现更灵活的脱敏控制。这套方案在笔者参与的银行系统中稳定运行两年多，处理了日均百万级的敏感数据请求。