Java日志脱敏应优先在JSON解析层或序列化层实现字段级精准脱敏，避免事后正则替换；推荐HandlerInterceptor/RequestBodyAdvice中解析JsonNode脱敏、Logback自定义Converter递归处理参数、或Jackson注解式声明脱敏，禁用toString脱敏和纯正则方案。
Java 中日志记录过滤敏感隐私数据，关键是在日志真正写入前完成脱敏，而不是事后用正则“碰运气”替换。直接打印 request 或 user.toString() 很容易把密码、手机号、身份证号全记进日志，而这些内容一旦落盘，就可能被运维、BI、甚至外包人员随意查看——比数据库泄露更难管控。
优先在 JSON 解析层做字段级脱敏
适用于 Spring MVC、Spring Boot Web 接口的日志拦截场景：
- 在
HandlerInterceptor.afterCompletion或自定义RequestBodyAdvice中获取原始 JSON 字符串 - 用 Jackson 的
ObjectMapper.readTree()解析为JsonNode，递归遍历所有 key - 对匹配白名单字段（如
password、mobile、idCard、bankCard）的 value 做掩码处理：手机号转为138****1234，密码直接替换成"***" - 脱敏后重新序列化成字符串用于日志输出，原始请求体不改动，不影响业务逻辑
用 Logback 自定义 Converter 精准控制参数脱敏
比纯文本正则更安全，能识别对象结构，避免误伤日志文案中的“password is invalid”这类正常语句：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 继承
ClassicConverter，重写convert(ILoggingEvent event) - 从
event.getArgumentArray()拿到每个日志参数（可能是 Map、DTO、List） - 对每个参数递归检查字段名：用反射读取
field.get(obj)，跳过代理和 null，不触发 getter 副作用（比如 Hibernate 懒加载） - 规则可外置为 JSON 配置文件，例如：
{"User": ["password","idCard"], "PayReq": ["cardNo","cvv"]}
结合注解 + 序列化层实现声明式脱敏
适合统一管理实体类中敏感字段，代码侵入小、可读性强：
立即学习“Java免费学习笔记（深入）”；
- 使用
@Sensitive(strategy = StrategyMobile.class)注解标记字段，如手机号、邮箱、身份证 - 集成 Jackson 时，配合
SimpleBeanPropertyFilter和FilterProvider，按接口动态启用不同脱敏粒度 - 或选用成熟框架如 Sensitive，内置手机号、邮箱、中文姓名、银行卡等十几种策略，支持自定义扩展
- 避免在
toString()方法里写脱敏逻辑——Spring Boot Actuator 等诊断模块会调用它，导致非日志场景也被污染
慎用纯正则方案，仅作兜底补充
Log4j2 的 %replace 或 Logback 的 %replace PatternLayout 可快速屏蔽简单模式，但有明显局限：
- 只能处理最终字符串，无法区分字段上下文，易误伤（如日志里出现 “token expired” 被当成 token 替换）
- 对嵌套 JSON、多层 Map、集合结构完全无感知，漏脱风险高
- 手机号、身份证等需保留部分明文的场景难以精细控制（比如只掩码中间段）
- 建议仅作为开发环境快速验证或历史系统临时补救手段，不作为主方案
