SpringBoot测试用例中H2数据库无法正常工作的问题排查

错误提示select PAS_CIO_SEQ1.nextval from dual语法错误，核心原因是H2数据库在Oracle兼容模式下，结合当前的Hibernate方言配置，无法正确解析Oracle风格的序列查询语句。虽然你在URL中添加了MODE=ORACLE，但方言配置和H2的适配逻辑存在冲突，同时自定义的数据源配置可能干扰了Spring Boot的自动适配。

1. 修正方言与H2配置的匹配 #

将application.yml中的my.dialect改为H2方言，并在URL中预创建所需序列：

my:
 dialect: org.hibernate.dialect.H2Dialect
 driverClassName: org.h2.Driver
 url: jdbc:h2:mem:testdb;DB_CLOSE_DELAY=-1;DB_CLOSE_ON_EXIT=FALSE;MODE=ORACLE;DATABASE_TO_UPPER=FALSE;INIT=CREATE SEQUENCE IF NOT EXISTS PAS_CIO_SEQ1 START WITH 1 INCREMENT BY 1;
 username: sa
 password:

spring:
 jpa: 
  hibernate:
   ddl-auto: create-drop

• 改用H2Dialect让Hibernate生成适配H2的SQL，同时MODE=ORACLE保留Oracle语法兼容特性。
• 通过INIT参数预创建序列PAS_CIO_SEQ1，避免Hibernate自动生成序列时的语法差异问题。

2. 调整自定义数据源配置的适配逻辑 #

在DataSourceConfiguration中，针对H2数据库添加专属配置，确保方言与驱动匹配：

@Configuration
@EnableJpaRepositories(basePackages = {
        "#service package" }, entityManagerFactoryRef = "DataSourceEntityManagerFactory", transactionManagerRef = "transactionManager")
public class DataSourceConfiguration {
    @Value("${my.driverClassName}")
    private String driver;

    @Value("${my.url}")
    private String url;

    @Value("${my.username}")
    private String username;

    @Value("${my.password}")
    private String password;

    @Value("${my.dialect}")
    private String dialect;

    @Bean
    public DataSource unittestDataSource() {
        DataSourceBuilder dataSourceBuilder = DataSourceBuilder.create();
        dataSourceBuilder.driverClassName(driver);
        dataSourceBuilder.url(url);
        dataSourceBuilder.username(username);
        dataSourceBuilder.password(password);
        return dataSourceBuilder.build();
    }

    @Bean
    public LocalContainerEntityManagerFactoryBean DataSourceEntityManagerFactory(
            @Qualifier("unittestDataSource") DataSource datasource) {
        EntityManagerFactoryBuilder builder = new EntityManagerFactoryBuilder(new HibernateJpaVendorAdapter(),
                new HashMap(), null);
        Builder factoryBuilder = builder.dataSource(datasource);
        factoryBuilder.packages("#service package");
        factoryBuilder.persistenceUnit("PU-unittest");
        factoryBuilder.jta(false);

        Map<String, String> additionalProperties = new HashMap<>();
        additionalProperties.put("hibernate.dialect", dialect);
        // 针对H2添加额外兼容配置
        if (driver.contains("h2")) {
            additionalProperties.put("hibernate.hbm2ddl.auto", "create-drop");
        }
        factoryBuilder.properties(additionalProperties);

        return factoryBuilder.build();
    }
}

3. 优化测试类注解，避免自动配置冲突 #

@DataJpaTest默认会自动配置嵌入式数据库，手动指定@ContextConfiguration可能覆盖适配逻辑，添加@AutoConfigureTestDatabase显式控制数据源：

@DataJpaTest
@ComponentScan("#service package")
@ContextConfiguration(classes = DataSourceConfiguration.class)
@AutoConfigureTestDatabase(replace = AutoConfigureTestDatabase.Replace.NONE) // 禁用自动替换自定义数据源
public class IdTest {
    // ... 原有测试代码
}

4. 验证实体的序列映射配置 #

检查MyObject实体的ID字段映射，确保序列名称与H2中预创建的一致：

@Entity
public class MyObject {
    @Id
    @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "PAS_CIO_SEQ1_GENERATOR")
    @SequenceGenerator(name = "PAS_CIO_SEQ1_GENERATOR", sequenceName = "PAS_CIO_SEQ1", allocationSize = 1)
    private Long id;

    // ... 其他字段
}

• H2的Oracle兼容模式并非完全等价Oracle，部分语法细节需要结合Hibernate方言调整。
• 自定义数据源配置时，要确保方言、驱动、URL参数三者匹配，避免硬编码导致的适配冲突。

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