Dynamic SQL如何复用

在 MyBatis / 通用“动态 SQL”场景里，复用的核心思路是：把“可变部分”和“公共部分”拆开，然后通过 include、片段、模板、参数化 等方式组合。下面按常见方案讲。

一、MyBatis 中最常见的复用方式（重点）

1️⃣ <sql> + <include>（最推荐）

把公共 SQL 片段抽出来复用。

<sql id="Base_Column_List">
  id, name, age, status
</sql>

<select id="selectUser" resultType="User">
  SELECT
    <include refid="Base_Column_List"/>
  FROM user
  WHERE 1=1
    <if test="name != null">
      AND name = #{name}
    </if>
</select>

✅ 适合：

• 字段列表
• WHERE 条件片段
• 排序规则

2️⃣ 带参数的 <sql> 片段

MyBatis 支持 <include> 传参（3.4+）

<sql id="likeCondition">
  AND ${column} LIKE CONCAT('%', #{value}, '%')
</sql>

<select id="search">
  SELECT * FROM user
  WHERE 1=1
    <include refid="likeCondition">
      <property name="column" value="name"/>
      <property name="value" value="tom"/>
    </include>
</select>

⚠️ ${column} 有 SQL 注入风险，只用于“列名/固定结构”

3️⃣ <where> / <set> 复用

避免手写 1=1

<sql id="User_Where">
  <if test="name != null">AND name = #{name}</if>
  <if test="age != null">AND age = #{age}</if>
</sql>

<select id="list">
  SELECT * FROM user
  <where>
    <include refid="User_Where"/>
  </where>
</select>

4️⃣ <trim> 做通用拼装（高级复用）

<trim prefix="WHERE" prefixOverrides="AND |OR ">
  <include refid="User_Where"/>
</trim>

二、Java 层面的动态 SQL 复用（非 XML）

5️⃣ MyBatis Provider（@SelectProvider）

适合复杂、可复用逻辑

public class UserSqlProvider {
  public String list(User u) {
    return new SQL(){{
      SELECT("*");
      FROM("user");
      if (u.getName() != null) WHERE("name = #{name}");
    }}.toString();
  }
}

✅ 好处：

• 可抽象成工具类
• 可单元测试

6️⃣ 抽象公共 Builder

public class SqlBuilder {
  public static String where(User u) {
    // 复用逻辑
  }
}

三、跨 Mapper 复用（很多人忽略）

✅ 同一 Mapper 内 <sql> 最常见

✅ 跨 Mapper 复用

<include refid="com.xxx.mapper.CommonMapper.Base_Column_List"/>

四、典型复用场景总结

五、常见坑 ⚠️

1. 滥用 ${} → SQL 注入
2. 片段过细 → 可读性差
3. 动态 SQL 里写业务逻辑 → 难以维护

如果你用的是 MyBatis-Plus / JPA / 原生 JDBC，或者想看“真实业务例子”，可以告诉我具体技术栈。