Java中安全打印脱敏SQL参数的核心是日志框架层统一拦截清洗，而非手动拼接；Log4j2用SensitiveRewritePolicy、Logback用自定义MessageConverter，结合P6Spy实现字段级可控脱敏。
Java 中安全地在日志中打印脱敏后的 SQL 参数，核心是**不让原始敏感值（如手机号、身份证、密码）以明文形式出现在日志文本里**，同时保留可读性与排障能力。这不是简单“把日志关掉”或“全替换成***”，而是有策略、可配置、不破坏日志结构的处理方式。
优先在日志框架层统一拦截脱敏
比起在每个 DAO 或 Service 里手动处理参数，更可靠的做法是在日志输出前做统一清洗。Log4j2 和 Logback 都支持此能力：
-
Log4j2 推荐用 RewritePolicy：引入
sensitive-log4j2包，配置SensitiveRewritePolicy，它能自动识别常见字段名（如mobile、idCard、email），对匹配到的 JSON/Key-Value 日志内容中的值进行掩码（如 138****1234）。 -
Logback 可扩展 MessageConverter：自定义
MessageConverter类，配合sensitive，在convert()中用正则提取 key-value 对，按 Apollo 或配置中心开关 + 字段白名单动态脱敏。 - 关键点：脱敏逻辑只作用于日志消息体（
event.getFormattedMessage()），不影响业务代码和数据库操作本身。
避免直接拼接敏感参数进日志字符串
以下写法存在风险，应禁止：
-
log.info("用户登录，手机号：" + user.getPhone() + "，IP：" + ip);→ 手机号明文落盘 -
log.debug("SQL执行：{}，参数：{}", sql, params);→ 若params是 Map 或对象，可能含未过滤字段
正确做法是使用占位符 + 脱敏 Layout / Converter，让日志框架在格式化阶段处理，而非 Java 字符串拼接阶段。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
结合 MyBatis/MyBatis-Plus 的 SQL 日志增强
MyBatis 默认打印的 Parameters: 123, "abc" 不带字段名，也难脱敏。可采取：
- 启用
mybatis-plus.configuration.log-impl=org.apache.ibatis.logging.stdout.StdOutImpl，获得带占位符的 SQL 和参数列表，但需额外工具解析； - 更推荐接入 P6Spy：替换 JDBC Driver，真实还原执行 SQL（含参数值），再通过 P6Spy 的
appender或自定义FormattingStrategy对 SQL 中的敏感字面量做正则替换（如'13812345678'→'138****5678'）； - 注意：P6Spy 处理的是最终 JDBC 层语句，因此能覆盖 XML、注解、动态 SQL 等所有来源，且不依赖 ORM 框架日志实现。
字段级可控脱敏配置示例
脱敏不是“一刀切”，要支持分级控制。例如：
- 开发环境：仅掩码手机号中间 4 位（
138****1234）； - 测试环境：邮箱只留前缀（
a***@b.com）； - 生产环境：身份证全隐藏（
110***********1234），但保留校验位长度提示； - 配置建议用远程配置中心（如 Apollo/Nacos），键如
log.sensitive.rules={"phone":"mask-4","idCard":"mask-8-4"}，运行时热加载。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
