动态SQL怎么兼容版本

“动态 SQL 怎么兼容版本”这个问题，常见场景有 数据库版本兼容、MyBatis 动态 SQL 兼容、应用/框架版本兼容 三类。下面按最常见情况给你说明。

一、MyBatis 动态 SQL 兼容多版本（最常见）

1️⃣ 使用 <choose>/<when>/<otherwise> 做版本分支

根据传入参数（如 dbType、version）选择不同 SQL。

<select id="query" parameterType="map" resultType="map">
  SELECT *
  FROM user
  <where>
    <choose>
      <when test="dbType == 'mysql'">
        AND create_time >= #{start}
      </when>
      <when test="dbType == 'oracle'">
        AND create_time >= TO_DATE(#{start}, 'YYYY-MM-DD')
      </when>
      <otherwise>
        AND 1=1
      </otherwise>
    </choose>
  </where>
</select>

✅ 优点：清晰、可控
❌ 缺点：SQL 会变复杂

2️⃣ 使用 <if> + 参数版本号

适合小版本差异。

<if test="version >= 2">
  AND status = 1
</if>
<if test="version < 2">
  AND is_active = 1
</if>

3️⃣ 抽象 SQL 片段（<sql> + <include>）

不同版本引用不同片段。

<sql id="mysqlCondition">
  AND create_time >= #{start}
</sql>

<sql id="oracleCondition">
  AND create_time >= TO_DATE(#{start}, 'YYYY-MM-DD')
</sql>

二、数据库版本兼容（MySQL / Oracle / PG）

1️⃣ 避免高版本专属语法

❌ 不兼容写法：

SELECT * FROM t LIMIT 10 OFFSET 5

✅ 兼容写法（Oracle）：

SELECT * FROM (
  SELECT ROWNUM rn, t.* FROM t
) WHERE rn BETWEEN 6 AND 10

2️⃣ 使用标准 SQL（ANSI SQL）

• COALESCE 替代 NVL / IFNULL
• CURRENT_DATE 替代数据库特有函数

3️⃣ 在 DAO 层屏蔽差异

• 不同数据库用不同 Mapper
• 或用多数据源 + 路由

三、Spring / 框架版本兼容

1️⃣ 避免使用已废弃 API

• 旧：SqlMapClient
• 新：SqlSession

2️⃣ 使用条件化 Bean

@Bean
@ConditionalOnProperty(name = "sql.mode", havingValue = "v1")
public SqlService sqlServiceV1() {
    return new SqlServiceV1();
}

四、推荐实践（总结）

✅ 动态 SQL 兼容版本的最佳方式：

1. 参数驱动（dbType / version）
2. SQL 片段抽象
3. 避免数据库私有语法
4. 在 DAO 层统一屏蔽差异

如果你指的是 某个具体技术（如 MyBatis-Plus、JPA、MySQL 5/8、Oracle 11g/19c），可以直接告诉我，我给你针对性方案。