如何直接测试MyBatis生成的Oracle SQL语法？规避H2适配问题

一、直接验证MyBatis生成的SQL语法（完全可行） #

你可以直接获取MyBatis运行时生成的完整SQL，再结合Oracle的语法校验能力验证合法性，不需要实际执行语句。具体做法：

• 利用MyBatis的SqlSessionFactory和MappedStatement拿到绑定参数后的最终SQL
• 借助Oracle的DBMS_SQL.PARSE存储过程做语法校验，或者用测试容器启动轻量Oracle实例做离线校验

示例代码：

@Autowired
private SqlSessionFactory sqlSessionFactory;

@Test
void checkSqlSyntax() {
    // 获取对应Mapper的MappedStatement
    MappedStatement ms = sqlSessionFactory.getConfiguration()
        .getMappedStatement("com.example.mapper.Table1Mapper.selectTop1");
    // 构造测试参数
    Map<String, Object> params = new HashMap<>();
    params.put("value1", "test_val");
    params.put("timestamp1", LocalDateTime.now());
    params.put("timestamp2", LocalDateTime.now());
    // 生成绑定后的SQL
    BoundSql boundSql = ms.getBoundSql(params);
    String generatedSql = boundSql.getSql();
    
    // 连接Oracle做语法解析（只校验不执行）
    try (Connection conn = DriverManager.getConnection("jdbc:oracle:thin:@//localhost:1521/ORCL", "test", "test")) {
        CallableStatement cs = conn.prepareCall("BEGIN DBMS_SQL.PARSE(?, ?, DBMS_SQL.NATIVE); END;");
        cs.setInt(1, 0); // 游标ID随便填0即可
        cs.setString(2, generatedSql);
        cs.execute();
        // 没抛异常就说明语法合法
    }
}

二、如果仍想用H2，针对你遇到的SQL问题的适配方法 #

1. SELECT语句的DESC FETCH FIRST问题 #

你的原SQL本身语法有误——Oracle中DESC是排序关键字，必须跟在ORDER BY后面，正确写法是：

SELECT COLUMN_1, COLUMN_2, COLUMN_2 
FROM TABLE1 
WHERE COLUMN_1=VALUE1 AND COLUMN2 BETWEEN TIMESTAMP1 AND TIMESTAMP2 
ORDER BY COLUMN_1 DESC -- 必须指定排序字段，原SQL缺了ORDER BY
FETCH FIRST 1 ROW ONLY

同时给H2开启Oracle兼容模式，在数据源URL中添加参数：
jdbc:h2:mem:testdb;MODE=Oracle;DATABASE_TO_LOWER=FALSE;DEFAULT_NULL_ORDERING=HIGH

2. INSERT语句的SYSTIMESTAMP问题 #

用MyBatis动态SQL根据数据库方言切换函数：

INSERT INTO TABLE2 (COLUMN_1, COLUMN_2) 
VALUES(123, 
  <choose>
    <when test="_databaseId == 'oracle'">SYSTIMESTAMP</when>
    <otherwise>CURRENT_TIMESTAMP()</otherwise>
  </choose>
)

然后在MyBatis配置中指定数据库ID映射：

mybatis:
  configuration:
    database-id-provider:
      type: DB_VENDOR
      properties:
        Oracle: oracle
        H2: h2

三、完整测试Oracle方言的最优方案：用Testcontainers启动真实Oracle实例 #

跳过H2的最佳方式是用测试容器跑一个真实的Oracle，完全模拟生产环境，不需要修改任何SQL：

• 添加Testcontainers的Oracle依赖
• 在测试类中自动启动Oracle容器，让Spring Boot连接到容器实例
• 直接执行CRUD测试，结果完全贴近生产

示例代码：

@Testcontainers
@SpringBootTest
class OracleIntegrationTest {

    @Container
    static OracleContainer oracleContainer = new OracleContainer("gvenzl/oracle-free:latest")
        .withUsername("test_user")
        .withPassword("test_pass");

    @DynamicPropertySource
    static void setDbProperties(DynamicPropertyRegistry registry) {
        registry.add("spring.datasource.url", oracleContainer::getJdbcUrl);
        registry.add("spring.datasource.username", oracleContainer::getUsername);
        registry.add("spring.datasource.password", oracleContainer::getPassword);
    }

    @Autowired
    private Table2Mapper table2Mapper;

    @Test
    void testInsertWithSystimestamp() {
        table2Mapper.insertRecord(123);
        Table2 record = table2Mapper.getById(123);
        assertNotNull(record.getColumn2());
    }
}

内容的提问来源于stack exchange，提问作者Avinash B