Java敏感字段脱敏核心是private字段+脱敏getter，Builder预脱敏、重写toString、不可变对象加固及日志双重防护。
Java 封装实现敏感字段脱敏输出，核心不是“把字段藏起来”，而是通过访问控制 + 逻辑内聚，让每次读取都自动走脱敏路径。原始值只在类内部受控存在，对外暴露的永远是处理后的结果。
用 private 字段 + 带脱敏逻辑的 getter
这是最直接、最可控的方式。敏感字段声明为 private，禁止外部直接访问；getter 方法里嵌入脱敏规则，调用时自动转换：
- 不写：
public String phone;或public String getPhone() { return phone; } - 改写：
private String phone;+public String getPhone() { return DesensitizeUtil.mobilePhone(phone); } - 可扩展：在 getter 中结合当前用户角色（如从 SecurityContext 获取），动态决定是否脱敏或掩码强度
Builder 模式中预脱敏初始化
对象构建阶段就隔离明文风险。尤其适用于从数据库或接口读取原始数据后立即封装的场景：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- Builder 的
build()方法中对敏感字段做一次默认脱敏，再构造不可变实例 - 示例：
this.idCard = DesensitizeUtil.idCardNum(this.idCard); return new User(this); - 注意：不修改传入参数本身，而是复制后脱敏，避免污染上游数据
重写 toString() 并配合日志脱敏配置
调试日志、异常堆栈、监控埋点常隐式调用 toString()，极易导致明文泄露：
立即学习“Java免费学习笔记（深入）”；
- 必须手动重写，逐个控制敏感字段输出形态（如邮箱显示为
u***@xxx.com） - 禁用 IDE 自动生成的版本，也不依赖反射遍历字段
- 搭配 Logback 的
MaskingPatternLayout或 Log4j2 的RegexFilter，形成双重防护 - 对集合类型（如
List<User>）需递归检查元素，避免漏脱敏
用不可变对象（Immutable）加固防线
一旦创建完成，敏感字段无法被修改，天然规避运行时篡改或并发误用：
- 字段声明为
private final String idCard; - 提供专用脱敏访问器：
public String getIdCardMasked() { return DesensitizeUtil.idCardNum(idCard); } - 序列化时用
@JsonIgnore忽略原始字段，仅暴露脱敏方法返回值 - 配合全参构造器和无 setter，彻底切断修改通道
