动态SQL如何适配多库

“动态 SQL 如何适配多数据库”通常出现在 MyBatis / MyBatis-Plus、JPA、Spring JDBC 等场景中。核心目标是：同一套 SQL 逻辑，在不同数据库（MySQL、Oracle、PostgreSQL、SQLServer…）上都能正确执行。

下面从 设计思路 → 常见方案 → 示例 三个层面说明。

一、核心设计思路

适配多库要解决的差异主要有：

1. 语法差异
   • 分页：LIMIT vs ROWNUM vs OFFSET FETCH
   • 字符串：CONCAT / ||
   • 日期函数：NOW() / SYSDATE
2. 函数差异
   • IFNULL / NVL / COALESCE
3. 类型差异
   • 自增主键、布尔、JSON
4. 执行差异
   • 批量插入、返回主键

✅ 原则：动态 SQL 只描述“逻辑”，不写死数据库语法

二、常见适配方案（由浅入深）

方案 1：MyBatis 的 databaseId（最推荐）

MyBatis 原生支持多库识别。

1️⃣ 配置 databaseIdProvider

mybatis:
  configuration:
    database-id: mysql

或 Java 配置：

@Bean
public DatabaseIdProvider databaseIdProvider() {
    VendorDatabaseIdProvider provider = new VendorDatabaseIdProvider();
    Map<String, String> map = new HashMap<>();
    map.put("MySQL", "mysql");
    map.put("Oracle", "oracle");
    provider.setProperties(map);
    return provider;
}

2️⃣ Mapper 中使用 databaseId

<select id="list" resultType="User">
  <if test="_databaseId == 'mysql'">
    SELECT * FROM user LIMIT #{offset}, #{size}
  </if>
  <if test="_databaseId == 'oracle'">
    SELECT * FROM (
      SELECT u.*, ROWNUM rn FROM user u
    ) WHERE rn BETWEEN #{offset}+1 AND #{offset}+#{size}
  </if>
</select>

✅ 优点：清晰、官方支持
❌ 缺点：SQL 会变长

方案 2：动态 SQL 构建器（Java 控制）

适合 复杂条件 + 多库逻辑

public String buildPageSql(String dbType) {
    if ("mysql".equals(dbType)) {
        return " LIMIT ?, ?";
    } else if ("oracle".equals(dbType)) {
        return " OFFSET ? ROWS FETCH NEXT ? ROWS ONLY";
    }
    throw new UnsupportedOperationException();
}

用在：

• MyBatis @SelectProvider
• JPA @Query + 自定义 Repository

方案 3：使用数据库抽象层（推荐大型系统）

MyBatis-Plus

PaginationInnerInterceptor interceptor = new PaginationInnerInterceptor();
interceptor.setDbType(DbType.MYSQL);

自动处理：

• 分页
• 主键生成
• 函数差异

JPA / Hibernate

spring:
  jpa:
    database-platform: org.hibernate.dialect.MySQL8Dialect

✅ 最省心
❌ 灵活性略低

方案 4：SQL 模板 + 方言（框架级）

适用于自研 ORM / 报表系统：

interface Dialect {
    String pageSql(String sql, int offset, int size);
}

class MysqlDialect implements Dialect {
    public String pageSql(String sql, int offset, int size) {
        return sql + " LIMIT " + offset + "," + size;
    }
}

三、常见多库差异速查表

四、最佳实践建议

✅ 优先顺序

1. 能用 ORM（MP / JPA）就用
2. 必须手写 SQL → 用 databaseId
3. 极端动态 → Java 构建 SQL

✅ 避免

• 在业务代码里大量 if (dbType.equals("mysql"))
• 同一条 SQL 写 3 套完全版本

如果你愿意，可以告诉我：

• 用的什么框架（MyBatis / MP / JPA）
• 支持哪些数据库
• 是分页 / 函数 / 批量插入问题

我可以直接给你可粘贴用的模板代码。