讲师中心 微信公众号
AI工具推荐 视频效率加速

Java中的日志脱敏与异常处理_防止在堆栈中泄露用户敏感数据

星敏姑娘_8951

星敏姑娘_8951

发布时间:2026-03-16 13:50:39

|

770人浏览过

|

来源于php中文网

原创

应通过SafeException包装器、MDC过滤器及Jackson序列化脱敏统一拦截敏感字段,禁用toString()拼接与哈希记录,全程使用不可逆占位符[REDACTED]并确保脱敏逻辑仅限日志层。

java中的日志脱敏与异常处理_防止在堆栈中泄露用户敏感数据

日志中打印异常时自动过滤敏感字段

Java默认的Exception.printStackTrace()或logger.error("msg", e)会把整个堆栈、变量值、甚至局部对象状态原样打出来,一旦对象里含password、idCard、token等字段,就直接泄露。

根本原因不是日志框架的问题,而是Throwable.toString()和printStackTrace()不识别业务语义——它只管反射取值,不管该不该打。

  • 用logger.error("请求失败", e)前,先调用自定义脱敏方法包装异常,不要依赖日志框架自动处理
  • 对e.getCause()和e.getSuppressed()递归脱敏,否则嵌套异常里的敏感信息照样逃逸
  • 避免重写toString()在实体类里做脱敏——这会影响所有调试、序列化、单元测试,污染面太大
  • 推荐在日志门面(如SLF4J)之上加一层SafeException包装器,只影响日志输出路径

Logback/Log4j2 中拦截并修改 MDC 和日志事件

很多团队用MDC.put("userId", user.getId())传上下文,但userId本身可能就是敏感ID(比如身份证号后6位),直接进日志模板就危险。

Logback支持Filter,Log4j2支持Layout或LoggerContext级处理器,关键不是“禁用MDC”,而是“可控地清洗”。

立即学习“Java免费学习笔记(深入)”;

Java调试
Java调试

通过 JDWP 实现 Java 远程调试:连接远程 JVM、设置断点、单步执行代码、查看变量值、获取调用栈。适用于需要调试远程 Java 应用、排查运行时状态、追踪代码执行流程的场景。 术语注解 JDWP:Java Debug Wire Protocol,Java 调试有线协议(Java 远程调试底层通信协议) remote JVM:远程 Java 虚拟机 step through code:代码单步调试(步入 / 步过 / 步出调试) inspect variables:变量查看 / 变量检视 stac

下载
  • Logback:写一个继承ch.qos.logback.core.filter.Filter的类,在decide()里调用event.getMDCPropertyMap(),对已知敏感key(如"idCard"、"phone")做replaceAll(".{3}(.{4})$", "*$1")再塞回去
  • Log4j2:用PatternLayout配合%X{userId:--}这种默认值语法没用,得靠ScriptPatternSelector或自定义LogEventFactory
  • 注意MDC是ThreadLocal,异步线程(如CompletableFuture)里MDC不会自动传递,脱敏逻辑若依赖MDC,必须显式MDC.copy()后再清理

toString() 和 JSON 序列化时的隐式脱敏陷阱

你以为只控制了日志输出就安全?错。很多团队在catch块里写logger.info("req="+req),而req.toString()或JSON.toJSONString(req)会触发全量字段输出,包括被@JsonIgnore忽略的字段。

尤其Jackson默认开启SerializationFeature.WRITE_NULLS和DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES以外的几乎所有特性,@JsonInclude(NON_EMPTY)也拦不住敏感字段的非空值。

  • 禁止在日志中拼接obj.toString(),哪怕你给实体写了“安全版”toString()——开发容易忘,Code Review难覆盖
  • 用Jackson时,全局配置SimpleModule注册BeanSerializerModifier,对标注了@Sensitive注解的字段统一替换为"***"
  • Lombok的@ToString(exclude = "password")只管Lombok生成的toString(),不影响Jackson、Hibernate、甚至IDE调试视图,别高估它的作用范围

异常堆栈中还原原始参数值的常见误操作

有人想“既然不能打原始值,那就打个哈希”——比如logger.error("token="+DigestUtils.md5Hex(token))。这反而更危险:攻击者可构造碰撞哈希反推原文,或利用日志中的哈希+已知算法批量爆破。

还有人用Arrays.toString(charArray)打密码数组,殊不知char[]转字符串后,GC前仍驻留堆内存,堆转储(heap dump)里一抓一个准。

  • 日志中任何涉及敏感数据的操作,目标不是“变形”,而是“不可逆地擦除”——最稳妥是打固定占位符"[REDACTED]",且确保该字符串不在业务逻辑中被误用
  • 不要依赖String::strip()或substring()来“隐藏”,它们只是创建新字符串,旧字符串还在堆里,直到GC
  • 如果必须记录标识性信息(如脱敏后的手机号138****1234),确保该逻辑只在日志适配层执行,且与业务代码完全隔离,防止误当真实值使用

真正难的不是写脱敏逻辑,而是让所有logger.xxx()调用点都经过同一套清洗管道——中间只要漏掉一个System.out.println()、一个IDE调试断点、一次临时加的日志,整条链路就失效。

热门AI工具

更多
Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

12117

2023.06.15

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

9202

2023.07.05

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

7872

2023.07.31

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

1284

2023.08.01

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

1028

2023.08.02

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

1536

2023.08.02

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

3169

2023.08.02

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

20411

2023.08.03

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

0

2026.11.06

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn