java日志脱敏核心是安全地记录敏感字段，推荐在logback/log4j2框架层通过自定义converter或filter统一拦截处理，其次在业务代码中预处理参数，需避免tostring()和json泄露、确保异步mdc传递，并通过单元测试验证效果。
在 Java 项目中实现日志脱敏，核心是不让密码、手机号、身份证号、银行卡号等敏感字段明文出现在日志文件或控制台中。关键不是“不打日志”，而是“有选择地打、安全地打”。
日志脱敏的常见场景
以下字段通常需要脱敏处理：
- 用户手机号：138****1234
- 身份证号：11010119900307****
- 银行卡号：6228 **** **** 1234
- 邮箱地址：user***@domain.com
- 密码、token、密钥等：一律用 *** 或 [REDACTED] 替代，禁止任何形式的截取显示
推荐的脱敏方式（按优先级）
1. 在日志框架层统一拦截（最推荐）
使用 Logback 或 Log4j2 的 PatternLayout + 自定义 Converter 或 Filter，对日志内容做实时清洗。
例如 Logback 中定义一个 MaskingPatternLayout，识别 JSON 日志中的 key（如 "phone"、"idCard"），自动替换 value。配合 MDC（Mapped Diagnostic Context）传入标记，可精准控制哪些日志需脱敏。
2. 在业务代码中预处理参数
记录日志前，对敏感对象做脱敏再打印：
- 使用工具类（如 Apache Commons Text 的
StringEscapeUtils或自定义DesensitizationUtil）处理字段 - 避免直接
log.info("user: {}", user)，改用log.info("user: {}", DesensitizationUtil.mask(user)) - DTO/VO 类可加注解（如
@Desensitize(field = "phone")），配合 AOP 或 Jackson 序列化时自动脱敏
避免踩坑的关键细节
不要依赖前端或调用方传来的“已脱敏数据” —— 后端必须独立校验和脱敏，因为上游可能绕过校验。
警惕 toString() 和 JSON 序列化泄露 —— 某些 ORM 实体或 Map 打印时会自动展开全部字段，建议重写 toString() 或使用专门的日志 DTO。
异步日志注意线程上下文丢失 —— 若用 MDC 控制脱敏开关，需确保 MDC.getCopyOfContextMap() 正确传递到异步线程。
测试环节必须验证脱敏效果 —— 写单元测试检查日志输出是否含原始敏感值，尤其关注异常堆栈、SQL 日志、Feign 调用日志等易忽略位置。
简单实用的脱敏工具示例
一个轻量级手机号脱敏方法：
public static String maskPhone(String phone) {
if (phone == null || phone.length() 配合 Lombok 的 @Log 注解时，可封装成通用日志包装器，替代直接调用 log.info()。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
