讲师中心 微信公众号

工具推荐

视频效率加速
updream

一键生成高质量推广成片

立刻MV
立刻MV

低成本歌曲 MV、视频生成

Laper
Laper

剧本策划到成片协作

Seko
Seko

AI短剧一键生成成片

异常处理中的“日志脱敏”实战:编写自定义脱敏器防止异常堆栈输出数据库变量连接串信息

千辰吖_3684

千辰吖_3684

发布时间:2026-05-12 10:46:47

|

944人浏览过

|

来源于php中文网

原创

异常日志脱敏关键在于拦截Throwable的toString()、日志参数序列化及message拼接三处,递归扫描cause链并正则匹配pwd=、password=、jdbc://等敏感字段,替换值为*,同时规范自定义异常toString()、禁用MDC直接输出原始连接串。

异常处理中的“日志脱敏”实战:编写自定义脱敏器防止异常堆栈输出数据库变量连接串信息

异常处理中日志脱敏的关键,不是删掉堆栈,而是不让数据库连接串、密码、token、绝对路径等敏感内容进入日志文本。重点在于拦截原始异常的 toString() 输出、日志参数序列化过程、以及日志框架最终拼接的 message 字符串——这三处最容易泄露连接字符串中的 pwd=、password=、jdbc:mysql://user:pass@host 等片段。

识别并拦截异常中的连接串敏感字段

数据库连接串常以字符串形式出现在异常 cause 的 message 或 stack trace 中(例如 SQLException 报错时直接打印完整 URL)。脱敏器需在日志写入前扫描 Throwable 对象:

  • 递归遍历 getCause() 链,提取每个异常的 getMessage() 和 toString()
  • 对提取出的字符串执行正则匹配:pwd=([^;\s]+)|password=([^;\s]+)|jdbc:[^\s]*?://[^@]+@
  • 匹配到后,用 *** 替换值部分,保留键名和结构(如 pwd=***、jdbc:mysql://root:***@localhost:3306/db)
  • 注意避开误伤:不匹配含 password 的变量名(如 oldPassword),只匹配独立参数格式

定制日志事件处理器,统一过滤异常日志

不依赖业务代码手动调用工具类,而是从日志框架入口统一拦截。以 Logback 为例:

  • 继承 ch.qos.logback.core.AppenderBase,重写 append(ILoggingEvent event)
  • 检查 event.getThrowableProxy() 是否非空
  • 若存在,用脱敏逻辑清洗其 getMessage() 和各 StackTraceElement.toString() 中的连接串
  • 再调用父类 super.append(event) 输出净化后的日志
  • 该 Appender 可全局替换 ConsoleAppender 或 RollingFileAppender,零侵入

避免 toString() 泄露 —— 尤其针对自定义异常包装类

很多项目会用 BusinessException 包装原始异常,但若重写 toString() 时调用 super.toString(),就会把底层 SQLException 的完整连接 URL 带出来:

  • 错误写法:return super.toString() + ", code=" + errorCode;
  • 正确写法:return getClass().getSimpleName() + "[code=" + errorCode + ", msg=" + message + "]";
  • 禁止在 getMessage() 中拼接 getCause().getMessage(),除非已确认该 cause 已脱敏
  • 若必须保留 cause 用于内部诊断,应在构造时传入,但对外输出完全隔离

配合 MDC 实现请求级上下文脱敏

某些异常日志会通过 MDC.put("dbUrl", url) 主动注入连接信息用于追踪——这属于高危行为,必须约束:

  • 在日志 pattern 中禁用 %X{dbUrl} 这类直接输出 MDC 值的写法
  • 改用安全键名,如 mdc.dbId,再通过映射表查出脱敏后的标识(如 mysql-prod-01)
  • 或在 MDC put 前强制脱敏:MDC.put("dbUrl", Desensitizer.maskDbUrl(url))
  • 确保所有 filter、interceptor、aop 在写入 MDC 前完成校验,阻断原始连接串入库

热门AI工具

更多
讯飞智文

一款面向学习和办公场景的AI文档创作工具,可辅助生成PPT与Word文档,提高资料整理和内容制作效率。

WorkBuddy

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

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

码上飞
码上飞 Hot

一款基于自然语言的AI应用开发平台,可根据用户描述自动生成应用程序,帮助个人和团队快速完成应用原型与开发。

Flowith
Flowith Hot

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

DeepSeek

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

豆包大模型

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

相关专题

更多
堆和栈的区别
堆和栈的区别

堆和栈的区别:1、内存分配方式不同;2、大小不同;3、数据访问方式不同;4、数据的生命周期。本专题为大家提供堆和栈的区别的相关的文章、下载、课程内容,供大家免费下载体验。

6867

2023.07.18

堆和栈区别
堆和栈区别

堆(Heap)和栈(Stack)是计算机中两种常见的内存分配机制。它们在内存管理的方式、分配方式以及使用场景上有很大的区别。本文将详细介绍堆和栈的特点、区别以及各自的使用场景。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

2828

2023.08.10

堆和栈的区别
堆和栈的区别

堆和栈的区别:1、内存分配方式不同;2、大小不同;3、数据访问方式不同;4、数据的生命周期。本专题为大家提供堆和栈的区别的相关的文章、下载、课程内容,供大家免费下载体验。

6867

2023.07.18

堆和栈区别
堆和栈区别

堆(Heap)和栈(Stack)是计算机中两种常见的内存分配机制。它们在内存管理的方式、分配方式以及使用场景上有很大的区别。本文将详细介绍堆和栈的特点、区别以及各自的使用场景。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

2828

2023.08.10

数据库三范式
数据库三范式

数据库三范式是一种设计规范,用于规范化关系型数据库中的数据结构,它通过消除冗余数据、提高数据库性能和数据一致性,提供了一种有效的数据库设计方法。本专题提供数据库三范式相关的文章、下载和课程。

3125

2023.06.29

如何删除数据库
如何删除数据库

删除数据库是指在MySQL中完全移除一个数据库及其所包含的所有数据和结构,作用包括:1、释放存储空间;2、确保数据的安全性;3、提高数据库的整体性能,加速查询和操作的执行速度。尽管删除数据库具有一些好处,但在执行任何删除操作之前,务必谨慎操作,并备份重要的数据。删除数据库将永久性地删除所有相关数据和结构,无法回滚。

4181

2023.08.14

vb怎么连接数据库
vb怎么连接数据库

在VB中,连接数据库通常使用ADO(ActiveX 数据对象)或 DAO(Data Access Objects)这两个技术来实现:1、引入ADO库;2、创建ADO连接对象;3、配置连接字符串;4、打开连接;5、执行SQL语句;6、处理查询结果;7、关闭连接即可。

3511

2023.08.31

MySQL恢复数据库
MySQL恢复数据库

MySQL恢复数据库的方法有使用物理备份恢复、使用逻辑备份恢复、使用二进制日志恢复和使用数据库复制进行恢复等。本专题为大家提供MySQL数据库相关的文章、下载、课程内容,供大家免费下载体验。

1087

2023.09.05

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

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

60

2026.11.06

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
GDB Reference Card
GDB Reference Card

共0课时 | 0人学习

《Debugging with GDB》用户手册
《Debugging with GDB》用户手册

共0课时 | 0人学习

Valgrind FAQ
Valgrind FAQ

共0课时 | 0人学习

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

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