核心思路是将SQL和参数作为上下文信息附加到异常中,而非修改异常链本身;推荐通过自定义异常类封装SQL、参数及原始异常,或利用MDC在日志中注入执行上下文以实现可追溯诊断。
在 java 中,异常链中追加当前执行的动态 sql 参数,核心思路是:**将 sql 和参数作为上下文信息附加到异常中,而不是修改异常链本身**。java 的异常链(cause)用于表示“由谁引起”,不能直接“追加”业务数据;但你可以通过包装异常、设置消息、或利用异常的 fillinstacktrace() 之外的扩展能力(如自定义字段、throwable.addsuppressed() 或 mdc)来携带这些信息。
1. 在抛出异常前主动封装 SQL 和参数
最常用且推荐的方式:捕获原始异常(如 SQLException),构造一个新的业务异常(或自定义异常),把 SQL 模板、实际参数值、执行环境等一并写入异常消息或字段中。
- 避免直接 throw 原始异常,而是用
new RuntimeException("SQL: " + sql + ", Params: " + params, cause) - 更规范的做法是定义一个继承
RuntimeException的自定义异常类,例如SqlExecutionException,并添加sql、params、boundSql等字段 - 示例:
public class SqlExecutionException extends RuntimeException {
private final String sql;
private final Object[] params;
<pre class="brush:php;toolbar:false;">public SqlExecutionException(String sql, Object[] params, Throwable cause) {
super("Failed to execute SQL: " + sql + ", with params: " + Arrays.toString(params), cause);
this.sql = sql;
this.params = params;
}
// getter...}
使用时:
try {
jdbcTemplate.query(sql, params, rowMapper);
} catch (DataAccessException e) {
throw new SqlExecutionException(sql, params, e);
}2. 利用日志 MDC 在异常发生时自动注入上下文
如果你用的是 SLF4J + Logback/Log4j2,可在执行 SQL 前将 SQL 和参数写入 MDC(Mapped Diagnostic Context),这样即使后续任意位置抛出异常,只要日志配置了 MDC 输出,就能看到关联上下文。
- 在 DAO 层或拦截器中提前设置:
MDC.put("sql", sql); MDC.put("sql_params", JsonUtil.toJson(params)); - 确保日志 pattern 包含
%X{sql} %X{sql_params} - 注意 MDC 是线程绑定的,需在同一线程内清理(如
MDC.clear()或 try-finally)
3. 使用 PreparedStatement 的 toString()(仅限部分驱动,不推荐依赖)
某些 JDBC 驱动(如 HikariCP 包装后的代理、部分新版 PostgreSQL 驱动)会在 PreparedStatement.toString() 中返回带参数的 SQL(如 "SELECT * FROM user WHERE id = 123")。但这不是标准行为,MySQL Connector/J 默认不展开参数,且有安全风险(如敏感字段泄露)。
- 不可靠,不应作为主要方案
- 若临时调试可用:
e.printStackTrace(); System.out.println("Bound SQL: " + ps.toString());
4. 结合 MyBatis 的 BoundSql 进行增强
如果项目用 MyBatis,可借助 BoundSql 获取最终执行的 SQL 和参数映射结果:
- 在
Interceptor(如Executor拦截器)中获取boundSql.getSql()和boundSql.getParameterObject() - 将它们存入 ThreadLocal 或 MDC,或在异常处理器中统一提取并包装
- MyBatis-Spring-Boot-Starter 2.3+ 也支持
@Intercepts注入执行上下文
不复杂但容易忽略:关键不是“往异常链里塞东西”,而是让异常携带足够诊断信息——要么封装、要么记录、要么透传。选一种适合你技术栈和团队规范的方式即可。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











