动态SQL为何报语法错

“动态 SQL 报语法错”是一个很常见但原因很多的问题。下面按最常见原因 → 排查思路 → 示例来说明。

一、最常见原因

1️⃣ SQL 拼接时缺少空格

这是最容易犯的错误。

❌ 错误示例（MyBatis）：

<select id="test">
select * from user
<if test="name != null">
where name = #{name}
</if>
</select>

如果 name == null，SQL 会变成：

select * from user

✅ 没问题
但如果是：

select * from user
<if test="name != null">where name = #{name}</if>
<if test="age != null">and age = #{age}</if>

当 name == null 时：

select * from userand age = ?

→ 语法错误

✅ 正确写法：

where 1=1
<if test="name != null">and name = #{name}</if>
<if test="age != null">and age = #{age}</if>

或用 <where> 标签。

2️⃣ 使用了 ${} 但拼接内容非法

${} 是原样拼接 SQL，非常容易出错。

❌ 错误：

order by ${sortField} ${sortType}

如果 sortType = "desc;" 或 sortType = ""
→ SQL 语法错误

✅ 建议：

• 用白名单判断

if (!"asc".equals(sortType) && !"desc".equals(sortType)) {
    throw new IllegalArgumentException();
}

3️⃣ 引号或参数使用错误

❌ 错误（手写 SQL）：

where name = ${name}

如果 name = Tom → SQL 变成：

where name = Tom

✅ 应改为：

where name = #{name}

4️⃣ 动态 SQL 标签用错

常见错误：

• <if> 里写 SQL 片段不完整
• <foreach> 拼接 IN 为空

❌ 错误：

<foreach collection="ids" item="id" open="(" close=")" separator=",">
  #{id}
</foreach>

如果 ids 为空：

in ()

→ 语法错误

✅ 处理：

<if test="ids != null and ids.size() > 0">
  and id in
  <foreach ... >
</if>

5️⃣ 数据库方言不一致

例如：

• MySQL：limit
• Oracle：不支持 limit
• PostgreSQL：limit 可用但语法不同

✅ 动态 SQL 要区分数据库

二、快速排查方法

1. 打印最终 SQL

   • MyBatis：logImpl=STDOUT_LOGGING
   • JPA：show-sql=true

2. 看报错位置

   You have an error in your SQL syntax near '...'
   

   看 near 后面是什么

3. 复制到数据库客户端执行 最容易定位问题

三、如果你愿意，我可以直接帮你查

你可以贴出：

• 使用的框架（MyBatis / JPA / JDBC）
• 动态 SQL 代码
• 报错信息

我可以直接告诉你哪一行导致语法错误，以及怎么改。