SpringBoot升级后H2 v2.1.214中PageRequest引发测试SQL语法错误

问题根源 #

H2 2.x（从1.4.200升级到2.1.214）对SQL语法兼容性做了严格调整，同时Spring Boot 2.7.x配套的Spring Data JPA生成的分页SQL（LIMIT语法）在H2默认模式下不被支持，而生产环境Oracle使用的是FETCH NEXT/ROWNUM这类分页语法，测试环境未配置H2与Oracle语法兼容，最终导致冲突报错。

具体解决方案 #

1. 配置H2为Oracle兼容模式 #

在测试环境配置文件（如application-test.yml）中修改H2的JDBC URL，添加Oracle兼容参数并关闭自动小写转换（匹配Oracle表名大小写规则）：

spring:
  datasource:
    url: jdbc:h2:mem:testdb;DB_CLOSE_DELAY=-1;MODE=ORACLE;DATABASE_TO_LOWER=FALSE
    driver-class-name: org.h2.Driver
    username: sa
    password:

• MODE=ORACLE：让H2模拟Oracle的SQL语法规则，包括分页语句生成逻辑
• DATABASE_TO_LOWER=FALSE：避免H2自动将表名转为小写，匹配Oracle表名大小写敏感特性，同时可解决部分“表未找到”问题

2. 指定JPA兼容Oracle的方言 #

配置Spring JPA使用Oracle对应的Hibernate方言，确保生成的SQL完全匹配Oracle语法：

spring:
  jpa:
    database-platform: org.hibernate.dialect.Oracle12cDialect
    hibernate:
      ddl-auto: update
    show-sql: true

若偏好H2专属的Oracle兼容方言，也可替换为org.hibernate.dialect.H2Dialect，需配合上述MODE=ORACLE参数使用。

3. 验证分页功能 #

修改配置后，原有的PageRequest代码无需改动即可正常运行：

public Page<MyEntity> doSomething() {
    final Sort sort = Sort.by(Order.desc("column1"));
    final PageRequest pageRequest = PageRequest.of(0, 1000, sort);
    return myEntityRepository.findAll(pageRequest);
}

此时Hibernate会生成符合Oracle语法的分页SQL（如FETCH NEXT 1000 ROWS ONLY），避免LIMIT语法导致的报错。

额外说明 #

• 剩余“表未找到”问题：需确保实体类@Table注解指定的表名与Oracle生产环境一致（通常为大写），避免H2生成的表名与预期不符。
• BOOLEAN类型问题：你已通过将myBoolean = 0改为myBoolean = false解决，这是H2 2.x严格区分BOOLEAN与INTEGER类型的要求，需保持测试与生产环境查询语法一致。

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