Java日志脱敏核心是拦截格式化过程，在序列化前精准处理：Log4j2重写toSerializable()获取结构化参数，Logback覆盖doLayout()解析argumentArray或MDC，推荐用StructuredArgument传递键值对并按schema脱敏，避免正则误伤。
Java 日志系统中，通过自定义 Layout 实现敏感字段（如手机号）的过滤与脱敏，核心在于拦截日志事件的格式化过程，在序列化为字符串前对日志内容做针对性处理。Log4j2 和 Logback 是主流框架，实现方式略有不同，但思路一致：不修改业务代码，也不依赖正则全局替换（易误伤、难维护），而是基于结构化日志上下文或日志参数本身做精准识别与替换。
Log4j2 中继承 PatternLayout 并重写 toSerializable
Log4j2 的 PatternLayout 负责将 LogEvent 转为字符串。你可以继承它，在 toSerializable() 方法中获取日志参数（Object[]）或上下文数据（ThreadContext），对含敏感信息的字段进行脱敏。
- 重写
toSerializable(LogEvent event)，先调用父类生成原始字符串，再对关键字段（如 JSON body、Map 参数）做解析和替换 - 更推荐方式：使用
event.getContextData().toMap()或event.getMessage().getParameters()获取结构化数据，避免字符串解析风险 - 例如手机号匹配规则：
1[3-9]\d{9}，脱敏为138****1234；注意仅在明确标记为“敏感”或字段名匹配（如"phone"、"mobile"）时才处理，防止误脱敏 - 需配合
PatternLayout的%m（消息）、%X（上下文）等占位符，确保原始结构可被程序识别
Logback 中扩展 LayoutBase 并覆盖 doLayout
Logback 的 Layout 是抽象类，自定义时通常继承 LayoutBase 或直接实现 Layout<ILoggingEvent>。关键是在 doLayout(ILoggingEvent event) 中介入日志渲染流程。
- 从
event.getArgumentArray()获取方法参数，或用event.getMDC()提取 MDC 中的敏感键（如"userPhone"） - 若日志消息是 JSON 字符串（如 SLF4J 的
logger.info("req:{}", jsonStr)），可用轻量 JSON 解析器（如 Jackson TreeModel）定位并替换字段值，再序列化回字符串 - 避免在
doLayout中做耗时操作（如网络请求、复杂正则遍历全文），否则拖慢整个日志链路 - 建议将脱敏逻辑封装为独立工具类，支持白名单字段、掩码规则配置（如保留前3后4位），便于测试和复用
统一推荐：用 StructuredArguments + 自定义 Appender 配合 Layout
比起在 Layout 层硬解析字符串，更健壮的方式是让业务主动传递结构化数据，并由 Layout 或 Appender 按 schema 处理。SLF4J 3.x 支持 StructuredArgument，Log4j2/Logback 均可识别。
立即学习“Java免费学习笔记（深入）”；
- 业务侧写法：
logger.info("user login", keyValue("phone", "13812345678"), keyValue("id", 1001)) - 自定义 Layout 可检查
event.getMessage()是否为StructuredArgument类型，直接遍历键值对，对已知敏感 key（"phone"、"idCard"）应用脱敏函数 - 这种方式无需猜测字段位置，不依赖字符串格式，也规避了正则误匹配问题，适合微服务间日志标准化场景
- 配合日志采集端（如 Filebeat、Logstash）做二次校验，形成“编码层脱敏 + 传输层过滤”双保险
注意事项与避坑点
实际落地时，几个细节决定是否可靠：
- 脱敏不能影响日志可读性和排错能力——比如把所有数字都替成
****，会掩盖真实问题；应只针对明确语义的字段 - 多线程环境下，确保脱敏工具类无共享可变状态，避免脏数据或并发异常
- 异步日志（AsyncAppender）中，
LogEvent可能被复用，不要在 Layout 中修改原始 event 对象 - 测试必须覆盖边界情况：空值、null 字段、嵌套 JSON、超长手机号（如带国际码 +86138...）、非十一位数字等
