在MyBatis的映射文件里,动态SQL依靠一系列标签根据入参自动拼接语句。当开发者在同一级节点中同时写下if和choose,生成的SQL经常会出现where后面直接跟and、或者set里遗漏逗号的情况,数据库执行时就会报BadSql。理解标签的解析机制并规范书写顺序,是绕开这类错误的关键。

一、if与choose并列引发BadSql的原因
if标签的本质是“满足条件就插入这段内容”,多个if之间互不影响,可能一个都不成立,也可能全部成立。choose则类似Java里的switch,内部when按顺序匹配,命中一个就忽略其余,否则走otherwise。当这两者被放在同一个父标签(例如update的set区域或select的where区域)下并列书写,MyBatis会按文档顺序逐个解析,不会自动帮你在它们之间补空格或删多余连接词。
举例来说,若先写了一个if输出and name = #{name},紧接着写choose,其中when输出了and age = #{age},而当if不满足、choose的when也不满足时,这一整片区域可能什么都没生成;但如果外层没有where或trim做兜底清理,或者清理规则没覆盖choose开头的文本,就会出现where后面空着、或残留and的残缺语句,从而触发BadSql。这种结构上的断裂,是纯靠肉眼看XML很难发现的。
二、典型的错误写法示例
下面这段映射代码展示了最常见的坑:在select的where区域内,if和choose平起平坐,且没有用trim统一收口。
<select id="queryUser" parameterType="map" resultType="User">
select * from user
<where>
<if test="name != null">
and name = #{name}
</if>
<choose>
<when test="minAge != null">
and age >= #{minAge}
</when>
<when test="maxAge != null">
and age <= #{maxAge}
</when>
<otherwise>
and status = 1
</otherwise>
</choose>
</where>
</select>
当name为null,而minAge和maxAge也都为null时,if不输出,choose走入otherwise输出and status = 1。此时where标签内文本以and开头,虽然where标签自身会去掉首个and,看起来没问题;但如果把choose换成不带otherwise、且所有when都不命中的情况,where里就只剩空白,某些旧版本驱动仍可能拼出select * from user where交给数据库,直接BadSql。
更隐蔽的问题是:若开发者手动在choose的when里写了where能识别之外的前缀,或者把if和choose拆到不同嵌套层却共用一个set,就会让逗号管理失控。比如update里if给了column = #{val},choose的when也给了column2 = #{val2},一旦前者不执行后者执行,set尾部可能缺逗号,同样报语法错。
三、推荐的规避方案
第一种方案是用trim替代where或set,明确指定前缀清理规则,并把choose作为主分支,if只做前置补充。这样无论哪边不输出,trim都会按规则剔除多余连接符。
<select id="queryUserSafe" parameterType="map" resultType="User">
select * from user
<trim prefix="where" prefixOverrides="and |or ">
<if test="name != null">
and name = #{name}
</if>
<choose>
<when test="minAge != null">
and age >= #{minAge}
</when>
<when test="maxAge != null">
and age <= #{maxAge}
</when>
</choose>
</trim>
</select>
上面代码中,trim的prefixOverrides配置了and空格与or空格,即便if和choose都没有产生内容,trim不会强行加where;只要有一边输出,开头的and会被吃掉,不会留残缺。相比单纯用where,trim对并列结构的容忍度更高。
第二种方案是在业务层先把参数归并好,再只用一个choose或只用一个if,从源头减少混用。例如把name、minAge、maxAge的互斥逻辑在Java里转成单个queryType字段,XML中仅用choose匹配queryType,结构清晰也更好测。两种方案各有取舍:trim改写成本低,适合老项目修补;业务层归并更彻底,适合新模块设计。
四、调试与验证建议
定位此类BadSql时,建议开启MyBatis的SQL打印,把实际发出的语句贴到数据库客户端直接执行,观察where或set附近是否缺词。也可以在单元测试里用不同参数为空组合调用映射方法,覆盖if不命中、choose全不命中、两者都命中的情形。
对于复杂报表类SQL,可以把动态片段抽成sql片段用include引入,每个片段内部保证只用单一分支标签,避免在大段XML里穿插if和choose。长期看,团队约定“同一级动态标签不混用”能显著降低维护成本。