Java身份证脱敏案例如何开发

wen java案例 2026-06-29 23

Java身份证脱敏案例如何开发：从零到一构建安全的数据保护方案

📖 目录导读

为什么需要身份证脱敏
身份证脱敏的核心原理
Java身份证脱敏的4种实现方式
实战案例：基于Spring Boot的脱敏工具类
QA：开发中常见问题与解答
性能优化与最佳实践

为什么需要身份证脱敏

在当今数字化时代,身份证号码作为个人核心敏感信息，被广泛存储于各类业务系统中，根据《个人信息保护法》和《数据安全法》的要求，企业在处理个人信息时必须采取脱敏、加密等安全措施。身份证脱敏（ID Card Masking） 是指在不影响业务逻辑的前提下，将完整身份证号码中的部分字符替换为掩码字符（如），从而降低数据泄露风险。

Java身份证脱敏案例如何开发

实际场景举例：

客服系统展示：客服查看用户信息时，只需显示前6位和后4位，如：110101****5678
日志脱敏：防止日志中明文记录身份证号，导致审计风险
API接口返回：对外接口返回脱敏数据，内部存储使用加密或明文

身份证脱敏的核心原理

中国居民身份证号码为18位（末位可能是X），其结构为：

前6位：地址码（省、市、区）
中间8位：出生年月日（YYYYMMDD）
后3位：顺序码（奇数男、偶数女）
最后1位：校验码（0-9或X）

常见脱敏规则：

保留前6后4：保留地址码和最后4位，隐藏出生日期和顺序码（如 110101********5678）
保留前3后3：极端脱敏，仅保留开头3位和最后3位
随机掩码：将部分字符替换为随机数字（不常用，影响校验）

推荐方案：保留前6位和后4位，中间8位用替换，既兼容业务（可识别地区、校验后4位），又最大限度保护隐私。

Java身份证脱敏的4种实现方式

1 字符串替换法（最基础）

public static String maskIdCard(String idCard) {
    if (StringUtils.isBlank(idCard) || idCard.length() != 18) {
        return idCard;
    }
    return idCard.substring(0, 6) + "********" + idCard.substring(14);
}

优点：简单直接，性能高
缺点：硬编码长度，不灵活

2 正则表达式法（低耦合）

public static String maskIdCardWithRegex(String idCard) {
    if (idCard == null || idCard.length() != 18) {
        return idCard;
    }
    return idCard.replaceAll("(\\d{6})\\d{8}(\\d{4})", "$1********$2");
}

优点：正则语义清晰，支持校验
缺点：正则性能略低于直接操作字符串

3 Apache Commons Lang 工具类（企业级）

利用StringUtils.overlay()方法：

import org.apache.commons.lang3.StringUtils;
public static String maskIdCardCommons(String idCard) {
    if (StringUtils.length(idCard) != 18) {
        return idCard;
    }
    return StringUtils.overlay(idCard, "********", 6, 14);
}

优点：代码简洁，第三方库经严格测试
缺点：引入外部依赖

4 自定义注解+序列化（Spring Boot推荐）

使用Jackson注解实现自动脱敏：

@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
@JacksonAnnotationsInside
@JsonSerialize(using = IdCardMaskSerializer.class)
public @interface IdCardMask {}
public class IdCardMaskSerializer extends JsonSerializer<String> {
    @Override
    public void serialize(String value, JsonGenerator gen, SerializerProvider provider) {
        gen.writeString(maskIdCard(value));
    }
}
// 实体类使用
public class User {
    @IdCardMask
    private String idCard;
}

实战案例：基于Spring Boot的脱敏工具类

完整代码示例：

import org.springframework.stereotype.Component;
import org.springframework.util.StringUtils;
@Component
public class DataMaskUtil {
    /**
     * 身份证脱敏：保留前6后4，中间8位用*替换
     * @param idCard 原始身份证号
     * @return 脱敏后的身份证号
     */
    public static String maskIdCard(String idCard) {
        if (StringUtils.isEmpty(idCard) || idCard.length() != 18) {
            // 非18位身份证号，返回原值或空
            return idCard;
        }
        // 防止X被替换
        String prefix = idCard.substring(0, 6);
        String suffix = idCard.substring(14);
        return prefix + "********" + suffix;
    }
    /**
     * 手机号脱敏：保留前3后4
     */
    public static String maskPhone(String phone) {
        if (StringUtils.isEmpty(phone) || phone.length() != 11) {
            return phone;
        }
        return phone.replaceAll("(\\d{3})\\d{4}(\\d{4})", "$1****$2");
    }
    /**
     * 邮箱脱敏：保留用户名首字母和@后域名
     */
    public static String maskEmail(String email) {
        if (StringUtils.isEmpty(email) || !email.contains("@")) {
            return email;
        }
        String name = email.substring(0, email.indexOf("@"));
        String domain = email.substring(email.indexOf("@"));
        if (name.length() <= 1) {
            return email;
        }
        return name.charAt(0) + "****" + domain;
    }
}

单元测试验证：

@Test
public void testMaskIdCard() {
    String original = "110101199001011234";
    String masked = DataMaskUtil.maskIdCard(original);
    Assert.assertEquals("110101********1234", masked);
}