MyBatis动态SQL技巧与使用方法详解

本篇文章向大家介绍《MyBatis动态SQL编写技巧与方法详解》，主要包括，具有一定的参考价值，需要的朋友可以参考一下。

MyBatis动态SQL通过一系列XML标签实现灵活的SQL拼接，提升了代码可维护性和数据操作适应性。1.if标签用于条件判断，根据test属性决定是否包含SQL片段；2.where标签自动处理WHERE关键字及AND/OR前缀，避免冗余；3.set标签用于UPDATE语句，自动添加SET并处理末尾逗号；4.choose/when/otherwise实现多选一逻辑，适用于互斥条件查询；5.foreach遍历集合，常用于IN子句或批量操作；6.trim提供灵活控制，自定义前后缀及覆盖内容。处理空值时，通常在test中同时判断null和空字符串，或将空字符串转为NULL。复杂组合查询可通过嵌套if、手动加括号等方式构建逻辑。批量操作主要依赖foreach标签，支持INSERT、UPDATE、DELETE。使用#{}防止SQL注入，${}仅限动态表名列名。建议服务层预处理参数，避免SQL过于复杂影响可维护性。

MyBatis动态SQL的核心在于灵活构建SQL语句，它允许我们根据不同条件，在运行时动态地拼接SQL片段，极大提升了数据操作的适应性和代码的可维护性。这玩意儿，用好了能让你的Mapper文件活起来，告别一堆冗余的SQL分支。

解决方案

MyBatis动态SQL的实现，主要是通过它提供的一系列XML标签来完成的。这些标签就像一个个乐高积木，你可以根据业务逻辑自由组合，拼装出最终的SQL语句。

• if 标签： 这是最基础的条件判断，类似于Java里的if语句。它会根据test属性的布尔结果来决定是否包含内部的SQL片段。

  

  <select id="findUsers" resultType="User">
      SELECT * FROM user
      <where>
          <if test="username != null and username != ''">
              username = #{username}
          </if>
          <if test="age != null">
              AND age > #{age}
          </if>
      </where>
  </select>

  这里我常常会遇到一个问题，就是如果所有条件都不满足，标签会自己处理掉开头的AND或OR，这很省心，但如果是在非或标签里用if，就得自己注意前缀了。

• where 标签： 专门用于处理SQL语句中的WHERE子句。它会自动添加WHERE关键字，并智能地处理内部第一个条件前的AND或OR。如果内部没有任何条件成立，它也不会生成WHERE关键字，非常方便。

  

• set 标签： 主要用于UPDATE语句，它会自动添加SET关键字，并处理内部条件末尾的逗号。

  <update id="updateUser" parameterType="User">
      UPDATE user
      <set>
          <if test="username != null and username != ''">
              username = #{username},
          </if>
          <if test="email != null and email != ''">
              email = #{email},
          </if>
      </set>
      WHERE id = #{id}
  </update>

  我个人觉得set标签简直是更新操作的福音，以前手写得小心翼翼地处理最后一个逗号，现在完全不用操心了。

• choose/when/otherwise 标签： 类似于Java的switch语句，用于实现多选一的逻辑。MyBatis会从多个when条件中选择第一个满足的执行，如果没有when满足，则执行otherwise中的内容。

  <select id="searchProducts" resultType="Product">
      SELECT * FROM product
      <where>
          <choose>
              <when test="productName != null and productName != ''">
                  product_name LIKE CONCAT('%', #{productName}, '%')
              </when>
              <when test="category != null">
                  category = #{category}
              </when>
              <otherwise>
                  <!-- 默认情况，比如查询所有活跃产品 -->
                  status = 'active'
              </otherwise>
          </choose>
      </where>
  </select>

  这个在需要多条件互斥查询时特别好用，比如用户只能通过商品名或分类中的一个来搜索。

• foreach 标签： 强大的循环标签，用于遍历集合（List, Array, Set）或Map，常用于构建IN子句、批量插入或批量更新等场景。

  <select id="findUsersByIds" resultType="User">
      SELECT * FROM user WHERE id IN
      <foreach item="id" collection="list" open="(" separator="," close=")">
          #{id}
      </foreach>
  </select>

  这里的collection属性非常关键，如果是List，通常是list；如果是数组，是array；如果是Map，则是Map的键名。我有时会忘记这个，导致参数绑定失败，所以每次写都得确认下。

• trim 标签： 提供了最灵活的控制能力，可以自定义前缀、后缀，以及需要覆盖（删除）的前缀或后缀。当你发现where或set不能满足你的奇葩需求时，它就是你的救星。

  <trim prefix="WHERE" prefixOverrides="AND |OR " suffixOverrides=",">
      <if test="username != null">AND username = #{username}</if>
      <if test="email != null">OR email = #{email}</if>
  </trim>

  比如我遇到过需要在GROUP BY后动态添加HAVING条件，trim就能派上用场。

在MyBatis动态SQL中处理空字符串和NULL值的最佳实践是什么？

这真是个老生常谈的问题，但又不得不提。在Java里，null和空字符串""是两码事，但在数据库查询里，很多时候我们希望它们行为一致，或者至少能区分开来。

最常见的处理方式是在test属性中同时判断null和空字符串：test="username != null and username != ''"。这几乎成了我的肌肉记忆，每次写条件查询都会带上这个。它能有效避免因为传入空字符串而导致查询结果不符合预期，或者直接报错。

有时候，我会考虑把一些空字符串转NULL的逻辑放到数据库层面，比如通过IFNULL或NULLIF函数。但这要看具体业务场景和数据库支持。另外，偶尔也会遇到参数类型不匹配导致的问题，比如数字类型字段传了空字符串。MyBatis默认的类型处理器会尝试转换，但如果转换失败就会抛异常。这时，确保前端传过来的数据类型与Mapper接口的参数类型一致，或者在业务层做预处理，会省去很多麻烦。

个人经验是，我通常倾向于在Java服务层就对传入参数进行初步校验和清洗，比如将所有业务意义上的“空”字符串统一转为null，这样Mapper层的动态SQL可以更专注于null判断，逻辑会更清晰。但如果业务需求就是区分空字符串和null，那就老老实实写!= ''和!= null。

如何有效利用MyBatis动态SQL编写复杂的组合查询条件？

复杂的组合查询，往往意味着AND和OR的嵌套。MyBatis的动态SQL标签本身是扁平化的，但通过巧妙的组合和嵌套，完全可以构建出非常复杂的逻辑。

处理AND与OR的优先级时，默认情况下AND的优先级高于OR。当我们需要改变优先级时，就必须引入括号。MyBatis动态SQL本身不直接提供括号标签，但我们可以通过在SQL片段中手动添加括号来实现。

<select id="findComplexUsers" resultType="User">
    SELECT * FROM user
    <where>
        <if test="conditionA != null">
            condition_a = #{conditionA}
        </if>
        <if test="conditionB != null or conditionC != null">
            AND (
                <if test="conditionB != null">
                    condition_b = #{conditionB}
                </if>
                <if test="conditionC != null">
                    OR condition_c = #{conditionC}
                </if>
            )
        </if>
    </where>
</select>

注意看上面，AND ( 和 ) 是我手动加的，这是处理复杂逻辑的关键。内部的OR条件，如果只有一个成立，MyBatis的where标签会智能处理掉多余的OR，但这里因为有括号，所以内部的OR需要更小心。通常我会让内部的第一个条件不带OR或AND，后续的条件才带。

在某些极端复杂的场景，你甚至可以在一个大的where标签内部，再嵌套一个trim或另一个where（虽然不常见，但理论上可行，不过会增加阅读难度）。我个人觉得，如果SQL复杂到需要这样嵌套，可能就要考虑是不是业务逻辑可以在服务层拆分，或者考虑使用更高级的查询工具，或者直接写存储过程了。

我的一个忠告是，动态SQL再强大，也别把它当成万能钥匙。当一个Mapper文件里的动态SQL逻辑变得像一团乱麻时，它就失去了可维护性。这时候，考虑拆分SQL，或者在Java代码层面进行一些条件判断和SQL片段的拼接（虽然这会失去MyBatis的便利，但有时是必要的妥协）。

另外，动态SQL的参数都是通过#{}占位符绑定的，这能有效防止SQL注入，因为MyBatis会使用PreparedStatement。但如果你在动态SQL中使用了${}，那就要特别小心了，它会直接拼接字符串，有SQL注入风险，通常只用于动态表名或列名。

MyBatis动态SQL在批量操作（插入、更新、删除）中的应用技巧有哪些？

批量操作是提升数据库性能的重要手段，MyBatis的动态SQL在这里扮演了不可或缺的角色，尤其是foreach标签。

批量插入 (INSERT BATCH)： 这是最常见的批量操作场景。foreach可以用来构建多条VALUES子句。

<insert id="batchInsertUsers" parameterType="java.util.List">
    INSERT INTO user (username, email, create_time) VALUES
    <foreach collection="list" item="user" separator=",">
        (#{user.username}, #{user.email}, NOW())
    </foreach>
</insert>

这里需要注意的是，不同的数据库对批量插入的语法支持有所不同。上述是最常见的MySQL风格。如果是Oracle，可能需要用ALL关键字和UNION ALL来模拟。

批量更新 (UPDATE BATCH)： 批量更新相对复杂一些，因为每个更新的条件和值可能不同。一种常见做法是利用CASE WHEN结合foreach。

<update id="batchUpdateStatus" parameterType="java.util.List">
    UPDATE user
    <set>
        status = CASE id
        <foreach collection="list" item="item" index="index">
            WHEN #{item.id} THEN #{item.status}
        </foreach>
        END
    </set>
    WHERE id IN
    <foreach collection="list" item="item" separator="," open="(" close=")">
        #{item.id}
    </foreach>
</update>

这种方式在处理少量数据时很方便，但如果批量更新的数据量非常大，比如几万条，这种CASE WHEN的SQL可能会变得非常长，数据库执行效率会下降。这时，我通常会考虑分批次提交，或者使用数据库连接池的addBatch()方法配合executeBatch()来执行。

批量删除 (DELETE BATCH)： 批量删除通常也用foreach构建IN子句，这和批量查询的IN子句非常相似。

<delete id="batchDeleteUsers" parameterType="java.util.List">
    DELETE FROM user WHERE id IN
    <foreach collection="list" item="id" separator="," open="(" close=")">
        #{id}
    </foreach>

今天关于《MyBatis动态SQL技巧与使用方法详解》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！