Spring/Hibernate/JPA中HSQL DB无法修改Schema的问题

在Java单元测试中使用HSQL内存数据库，通过Hibernate/JPA/Spring完成配置启动。默认Schema为PUBLIC，但被测代码中硬编码了Schema为ABC，尝试以下方法修改Schema均失败：

• 执行SQL语句 CREATE SCHEMA ABC, SET INITIAL SCHEMA ABC，出现「Schema not found」错误
• 执行SQL语句 ALTER CATALOG RENAME PUBLIC TO ABC，同样出现「Schema not found」错误
• 尝试在环境初始化时通过EntityManager的JPA属性配置Schema，却出现「domain.packages.to.scan」中某类的「Dependent Bean not found」错误

方法1：通过HSQLDB URL预初始化Schema #

HSQLDB支持在JDBC URL中通过INIT参数执行初始化SQL，数据库启动时就会创建并切换到目标Schema，避免启动后修改的问题。

在Spring测试配置文件（如application-test.properties）中配置：

spring.datasource.url=jdbc:hsqldb:mem:testdb;INIT=CREATE SCHEMA IF NOT EXISTS ABC\\;SET SCHEMA ABC
spring.datasource.username=sa
spring.datasource.password=
spring.datasource.driver-class-name=org.hsqldb.jdbcDriver

注意：URL中的分号需要用双反斜杠\\转义，否则Spring会将其视为配置项分隔符。

方法2：配置Hibernate默认Schema并修复Bean扫描问题 #

如果被测代码中实体类硬编码了@Table(schema = "ABC")，需让Hibernate默认使用该Schema，同时确保所有依赖Bean被正确加载：

1. 在Spring配置中指定Hibernate默认Schema：

spring.jpa.properties.hibernate.default_schema=ABC

2. 在测试类或配置类中明确指定实体和Repository的扫描路径：

@SpringBootTest
@EntityScan(basePackages = "domain.packages.to.scan")
@EnableJpaRepositories(basePackages = "your.repository.package.path")
public class YourTestClass {
    // 测试逻辑
}

替换成实际的实体包和Repository包路径，确保Spring能扫描到所有依赖的Bean，解决「Dependent Bean not found」错误。

方法3：用初始化脚本创建并切换Schema #

将Schema操作语句放在SQL脚本中，让Spring在数据源启动时自动执行：

1. 在src/test/resources下创建schema.sql：

CREATE SCHEMA IF NOT EXISTS ABC;
SET SCHEMA ABC;

2. 在Spring配置中指定初始化脚本：

spring.datasource.initialization-mode=always
spring.datasource.schema=classpath:schema.sql

这种方式会在数据源初始化阶段优先执行脚本，后续Hibernate/JPA的操作都会基于ABC Schema进行。

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