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>这里我常常会遇到一个问题，就是如果所有条件都不满足，<where>标签会自己处理掉开头的AND或OR，这很省心，但如果是在非<where>或<set>标签里用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就能派上用场。
这真是个老生常谈的问题，但又不得不提。在Java里，null和空字符串""是两码事，但在数据库查询里，很多时候我们希望它们行为一致，或者至少能区分开来。
最常见的处理方式是在test属性中同时判断null和空字符串：test="username != null and username != ''"。这几乎成了我的肌肉记忆，每次写条件查询都会带上这个。它能有效避免因为传入空字符串而导致查询结果不符合预期，或者直接报错。
有时候，我会考虑把一些空字符串转NULL的逻辑放到数据库层面，比如通过IFNULL或NULLIF函数。但这要看具体业务场景和数据库支持。另外，偶尔也会遇到参数类型不匹配导致的问题，比如数字类型字段传了空字符串。MyBatis默认的类型处理器会尝试转换，但如果转换失败就会抛异常。这时，确保前端传过来的数据类型与Mapper接口的参数类型一致，或者在业务层做预处理，会省去很多麻烦。
个人经验是，我通常倾向于在Java服务层就对传入参数进行初步校验和清洗，比如将所有业务意义上的“空”字符串统一转为null，这样Mapper层的动态SQL可以更专注于null判断，逻辑会更清晰。但如果业务需求就是区分空字符串和null，那就老老实实写!= ''和!= null。
复杂的组合查询，往往意味着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在这里扮演了不可或缺的角色，尤其是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编写详细方法与技巧的详细内容，更多请关注php中文网其它相关文章！
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移，垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是，许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
227
收藏
