MyBatis 動態 SQL 標籤避坑指南：解決 WHERE 1=1 與 AND/OR 殘留問題

MyBatis 的動態 SQL 功能極大簡化了條件查詢的編寫，但 <if> 標籤若使用不當，極易產生語法錯誤的 SQL。最經典的坑就是：當所有條件都不滿足時，SQL 殘留孤立的 WHERE 關鍵字；或首個條件失效導致殘留 AND/OR。本文深度解析 <where>、<trim>、<set> 標籤的智能修剪機制，助你寫出健壯的動態 SQL。

問題場景重現

假設我們要實現一個部落格多條件查詢，初學者常這樣寫：

<select id="findBlogs" resultType="Blog">
    SELECT * FROM BLOG
    WHERE
    <if test="userId != null"> state = 'ACTIVE' </if>
    <if test="title != null"> AND title LIKE #{title} </if>
    <if test="author != null"> AND author = #{author} </if>
</select>

❌ 產生的錯誤 SQL

核心解決方案： 標籤

<where> 是 MyBatis 提供的智能標籤，具備兩大核心功能：

1. 條件全滿足時自動插入 WHERE：只有內部至少有一個條件生效，才會在 SQL 中加入 WHERE 關鍵字。
2. 自動修剪首個 AND/OR：若第一個生效的條件前綴是 AND 或 OR，會自動移除。

✅ 正確寫法

<select id="findBlogs" resultType="Blog">
    SELECT * FROM BLOG
    <where>
        <if test="userId != null"> state = 'ACTIVE' </if>
        <if test="title != null"> AND title LIKE #{title} </if>
        <if test="author != null"> AND author = #{author} </if>
    </where>
</select>

✅ 驗證結果

進階場景：UPDATE 語句的 與

動態更新同樣面臨逗號殘留問題，MyBatis 提供 <set> 標籤專門解決：

<update id="updateBlog">
    UPDATE BLOG
    <set>
        <if test="title != null"> title = #{title}, </if>
        <if test="content != null"> content = #{content}, </if>
        <if test="author != null"> author = #{author}, </if>
    </set>
    WHERE id = #{id}
</update>

<set> 會自動移除最後一個生效條件尾部的逗號，若所有條件皆無效則不生成 SET 子句（需注意業務邏輯是否允許無字段更新）。

通用解決方案： 標籤

當 / 無法滿足複雜場景時，<trim> 提供完全可控的前後綴處理：

<!-- 等價於  -->
<trim prefix="WHERE" prefixOverrides="AND |OR ">
    <if test="state != null"> AND state = #{state} </if>
    <if test="title != null"> AND title LIKE #{title} </if>
</trim>

<!-- 等價於  -->
<trim prefix="SET" suffixOverrides=",">
    <if test="name != null"> name = #{name}, </if>
    <if test="age != null"> age = #{age}, </if>
</trim>

• prefix：內容非空時前置的字串
• prefixOverrides：移除內容開頭匹配的字串（支援多值用空格分隔）
• suffix：內容非空時後綴的字串
• suffixOverrides：移除內容結尾匹配的字串

最佳實踐總結

1. 查詢類 SQL：優先使用 <where>，簡潔且語義清晰。
2. 更新類 SQL：優先使用 <set>，自動處理逗號問題。
3. 複雜邏輯：靈活運用 <trim> 實現自定義前後綴修剪。
4. 測試驗證：務必測試「全空」、「首條件失效」、「中間條件失效」三種邊界情況。
5. 格式規範：在 <if> 內部 SQL 片段前統一加空格（如 AND ...），確保拼接後可讀性。

避坑口訣：動態 SQL 寫條件，where 標籤最貼心；首個 AND 別擔心，自動修剪零負擔。更新用 set 別犯愁，尾部逗號自消除。複雜場景 trim 來湊，前後綴隨心控制。

掌握 MyBatis 動態 SQL 的智能標籤，能讓你從繁瑣的字串拼接邏輯中解脫，專注於業務邏輯本身，編寫出既優雅又健壯的持久層代碼。