SpringBoot中的數(shù)據(jù)脫敏處理詳解

更新時(shí)間：2025年03月10日 14:18:31 作者：wx_tangjinjinwx

本文介紹了在SpringBoot中進(jìn)行數(shù)據(jù)脫敏處理的方法,通過自定義注解和Jackson配置,可以輕松實(shí)現(xiàn)對(duì)敏感數(shù)據(jù)的脫敏,保護(hù)用戶隱私

Spring Boot中的數(shù)據(jù)脫敏處理

今天我們來探討一下在Spring Boot中如何進(jìn)行數(shù)據(jù)脫敏處理。

1. 引言

數(shù)據(jù)脫敏是指對(duì)敏感數(shù)據(jù)進(jìn)行部分或全部掩蓋，以保護(hù)數(shù)據(jù)隱私。

在實(shí)際應(yīng)用中，我們常常需要在日志、API響應(yīng)或者數(shù)據(jù)庫中對(duì)敏感數(shù)據(jù)進(jìn)行脫敏處理，比如身份證號(hào)、手機(jī)號(hào)、郵箱地址等。

Spring Boot提供了強(qiáng)大的框架支持，使得我們可以輕松地實(shí)現(xiàn)數(shù)據(jù)脫敏。

2. 數(shù)據(jù)脫敏的場(chǎng)景

常見的數(shù)據(jù)脫敏場(chǎng)景包括：

日志記錄：防止敏感信息在日志中泄露。
API響應(yīng)：保護(hù)用戶隱私，防止敏感信息暴露給客戶端。
數(shù)據(jù)庫存儲(chǔ)：在存儲(chǔ)之前對(duì)數(shù)據(jù)進(jìn)行脫敏處理，以確保數(shù)據(jù)安全。

3. 定義脫敏注解

我們首先定義一個(gè)注解@SensitiveData，用于標(biāo)記需要脫敏的字段。

package cn.juwatech.annotation;

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.FIELD)
public @interface SensitiveData {
    SensitiveType value();
}

同時(shí)，我們定義一個(gè)枚舉SensitiveType來表示不同的脫敏類型。

package cn.juwatech.annotation;

public enum SensitiveType {
    CHINESE_NAME, ID_CARD, PHONE_NUMBER, EMAIL
}

4. 實(shí)現(xiàn)脫敏處理器

接下來，我們實(shí)現(xiàn)一個(gè)脫敏處理器SensitiveDataSerializer，用于對(duì)標(biāo)記了@SensitiveData注解的字段進(jìn)行脫敏處理。

package cn.juwatech.util;

import cn.juwatech.annotation.SensitiveData;
import cn.juwatech.annotation.SensitiveType;
import com.fasterxml.jackson.core.JsonGenerator;
import com.fasterxml.jackson.databind.JsonSerializer;
import com.fasterxml.jackson.databind.SerializerProvider;

import java.io.IOException;

public class SensitiveDataSerializer extends JsonSerializer<String> {

    @Override
    public void serialize(String value, JsonGenerator gen, SerializerProvider serializers) throws IOException {
        SensitiveData sensitiveData = serializers.getActiveView().getAnnotation(SensitiveData.class);
        if (sensitiveData != null) {
            SensitiveType type = sensitiveData.value();
            switch (type) {
                case CHINESE_NAME:
                    gen.writeString(maskChineseName(value));
                    break;
                case ID_CARD:
                    gen.writeString(maskIdCard(value));
                    break;
                case PHONE_NUMBER:
                    gen.writeString(maskPhoneNumber(value));
                    break;
                case EMAIL:
                    gen.writeString(maskEmail(value));
                    break;
                default:
                    gen.writeString(value);
            }
        } else {
            gen.writeString(value);
        }
    }

    private String maskChineseName(String name) {
        if (name.length() <= 1) {
            return "*";
        }
        return name.charAt(0) + "*".repeat(name.length() - 1);
    }

    private String maskIdCard(String idCard) {
        return idCard.replaceAll("(\\d{4})\\d{10}(\\d{4})", "$1******$2");
    }

    private String maskPhoneNumber(String phoneNumber) {
        return phoneNumber.replaceAll("(\\d{3})\\d{4}(\\d{4})", "$1****$2");
    }

    private String maskEmail(String email) {
        int atIndex = email.indexOf("@");
        if (atIndex <= 1) {
            return "*".repeat(atIndex) + email.substring(atIndex);
        }
        return email.charAt(0) + "*".repeat(atIndex - 1) + email.substring(atIndex);
    }
}

5. 配置Jackson

為了讓Jackson在序列化時(shí)使用我們的脫敏處理器，我們需要進(jìn)行相關(guān)配置。

package cn.juwatech.config;

import cn.juwatech.util.SensitiveDataSerializer;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.module.SimpleModule;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class JacksonConfig {

    @Bean
    public ObjectMapper objectMapper() {
        ObjectMapper objectMapper = new ObjectMapper();
        SimpleModule module = new SimpleModule();
        module.addSerializer(String.class, new SensitiveDataSerializer());
        objectMapper.registerModule(module);
        return objectMapper;
    }
}

6. 使用脫敏注解

現(xiàn)在我們可以在需要脫敏的字段上使用@SensitiveData注解。例如：

package cn.juwatech.model;

import cn.juwatech.annotation.SensitiveData;
import cn.juwatech.annotation.SensitiveType;

public class User {

    private String username;

    @SensitiveData(SensitiveType.CHINESE_NAME)
    private String realName;

    @SensitiveData(SensitiveType.ID_CARD)
    private String idCard;

    @SensitiveData(SensitiveType.PHONE_NUMBER)
    private String phoneNumber;

    @SensitiveData(SensitiveType.EMAIL)
    private String email;

    // Getters and Setters
}

7. 控制器示例

最后，我們編寫一個(gè)控制器來測(cè)試數(shù)據(jù)脫敏功能。

package cn.juwatech.controller;

import cn.juwatech.model.User;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class UserController {

    @GetMapping("/user")
    public User getUser() {
        User user = new User();
        user.setUsername("johndoe");
        user.setRealName("張三");
        user.setIdCard("123456789012345678");
        user.setPhoneNumber("13800138000");
        user.setEmail("johndoe@example.com");
        return user;
    }
}

啟動(dòng)Spring Boot應(yīng)用并訪問/user端點(diǎn)，可以看到返回的JSON中敏感數(shù)據(jù)已經(jīng)被脫敏處理。