核心思路是将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 输出，就能看到关联上下文。
立即学习“Java免费学习笔记（深入）”；
- 在 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注入执行上下文
不复杂但容易忽略：关键不是“往异常链里塞东西”，而是让异常携带足够诊断信息——要么封装、要么记录、要么透传。选一种适合你技术栈和团队规范的方式即可。
