MyBatis动态SQL技巧与实战教程

MyBatis动态SQL是提升数据库操作灵活性的关键技术。本文深入探讨MyBatis动态SQL的编写技巧与实战方法，助你告别冗余SQL，提升代码可维护性。文章详细讲解了`if`、`where`、`set`、`choose/when/otherwise`、`foreach`和`trim`等核心标签的用法，以及在处理空值、构建复杂组合查询和批量操作中的应用。同时，强调了使用`#{}`防止SQL注入的重要性，并建议在服务层预处理参数，避免SQL过于复杂。掌握MyBatis动态SQL，能让你在面对复杂业务需求时，更加游刃有余，编写出更高效、更易于维护的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 * FROM user
      
          
              username = #{username}
          
          
              AND age > #{age}
          
      
  

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

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

  

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

  
      UPDATE user
      
          
              username = #{username},
          
          
              email = #{email},
          
      
      WHERE id = #{id}
  

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

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

  
      SELECT * FROM product
      
          
              
                  product_name LIKE CONCAT('%', #{productName}, '%')
              
              
                  category = #{category}
              
              
                  
                  status = 'active'
              
          
      
  

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

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

  
      SELECT * FROM user WHERE id IN
      
          #{id}
      
  

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

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

  
      AND username = #{username}
      OR email = #{email}
  

  比如我遇到过需要在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 * FROM user
    
        
            condition_a = #{conditionA}
        
        
            AND (
                
                    condition_b = #{conditionB}
                
                
                    OR condition_c = #{conditionC}
                
            )
        
    

注意看上面，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 INTO user (username, email, create_time) VALUES
    
        (#{user.username}, #{user.email}, NOW())
    

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

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

    UPDATE user
    
        status = CASE id
        
            WHEN #{item.id} THEN #{item.status}
        
        END
    
    WHERE id IN
    
        #{item.id}
    

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

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

    DELETE FROM user WHERE id IN
    
        #{id}
    

以上就是《MyBatis动态SQL技巧与实战教程》的详细内容，更多关于的资料请关注golang学习网公众号！