Dynamic SQL怎样调试错误

调试 Dynamic SQL（动态 SQL） 的错误，核心思路是：先看到最终生成的 SQL，再像普通 SQL 一样排查。下面按常见场景给你一套实用方法。

一、最关键的调试原则

永远先打印 / 输出最终执行的 SQL

动态 SQL 出错，90% 是因为拼接出的 SQL 不对，而不是执行逻辑错。

二、常见动态 SQL 场景及调试方法

1️⃣ MyBatis 动态 SQL

✅ 调试方式

• 开启 SQL 日志

# application.yml
logging:
  level:
    com.xxx.mapper: debug

或

mybatis.configuration.log-impl=org.apache.ibatis.logging.stdout.StdOutImpl

• 打印最终 SQL
  • 看控制台输出的 Preparing: 和 Parameters:
  • 注意：MyBatis 日志是 带 ? 的占位符 SQL

✅ 手动拼接调试

如果你用的是 <script> + @SelectProvider：

String sql = new SQL()
    .SELECT("*")
    .FROM("user")
    .WHERE("id = #{id}")
    .toString();
System.out.println(sql);

2️⃣ JDBC / PreparedStatement 动态拼接

String sql = "SELECT * FROM user WHERE 1=1 ";
if (name != null) sql += " AND name = ?";

✅ 调试方法

• 输出完整 SQL（替换 ?）

System.out.println(sql);

• 或调试时手动拼值（仅调试，不要上线）

String debugSql = sql.replace("?", "'" + name + "'");

3️⃣ Python（SQLAlchemy / 原生 SQL）

sql = f"SELECT * FROM user WHERE name = '{name}'"
print(sql)

⚠️ 注意 SQL 注入风险，仅调试用

4️⃣ Stored Procedure（存储过程）

SET @sql = CONCAT('SELECT * FROM ', table_name);
SELECT @sql;  -- 先打印
PREPARE stmt FROM @sql;

三、常见错误类型 & 排查清单

✅ 语法错误

• 少空格
• 多逗号
• 字符串没加引号
• 条件拼接 AND 前没有 WHERE

✅ 参数错误

• 类型不匹配
• NULL 没处理
• 日期格式不对

✅ 逻辑错误

• 条件永远为 true / false
• IN 子句为空

四、强烈推荐的调试技巧

✅ 技巧 1：先静态再动态

把动态 SQL 写死成一条 SQL，确认能跑通，再改成动态。

✅ 技巧 2：拆分调试

if (cond1) sql += " AND a = 1";
if (cond2) sql += " AND b = 2";

逐个打印 sql

✅ 技巧 3：用 SQL 客户端直接执行

把最终 SQL 复制到：

• MySQL Workbench
• Navicat
• DBeaver

看具体报错信息（比代码堆栈更清楚）

五、总结一句话

Dynamic SQL 调试 = 打印最终 SQL + 用数据库客户端验证

如果你愿意，可以：

• 贴一段你的 动态 SQL 代码
• 或描述 具体报错信息

我可以直接帮你定位问题。