Spring Boot项目中HSQL数据库无法通过data.sql初始化问题求助

1. 确认data.sql的位置与命名规范 #

• 必须将data.sql放在src/main/resources根目录下，不能嵌套在子文件夹中
• 若设置了spring.sql.init.platform=hsqldb，需将文件重命名为data-hsqldb.sql，否则Spring Boot无法识别加载

2. 验证SQL语句的正确性与兼容性 #

• 检查SQL语句是否符合HSQLDB语法：比如字符串必须用单引号包裹，主键自增需用IDENTITY而非MySQL风格的AUTO_INCREMENT
• 核对data.sql中的表名、字段名与Hibernate自动生成的表结构完全一致：通过启动日志中spring.jpa.show-sql=true输出的建表SQL对比，确保表名（如user或USER）、字段名严格匹配

3. 排查SQL执行顺序与依赖问题 #

• 若存在外键关联，需先插入主表数据，再插入从表数据，否则会触发约束异常导致整个data.sql执行中断
• 临时开启spring.sql.init.continue-on-error=true（默认值为false），即使某条SQL出错，后续语句仍会执行，便于定位具体错误语句

4. 核对Spring Boot版本对应的配置项 #

• Spring Boot 2.5+：当前配置spring.jpa.defer-datasource-initialization=true和spring.sql.init.mode=always是正确的，该配置能确保Hibernate先完成表创建，再执行data.sql
• Spring Boot 2.4及以下：需替换配置为spring.datasource.initialization-mode=always，且无需defer-datasource-initialization；若存在表创建顺序问题，可将spring.jpa.hibernate.ddl-auto改为create-drop

5. 查看日志定位执行问题 #

• 调整日志级别为DEBUG，重点查看org.springframework.jdbc.datasource.init包的日志：
  • 确认是否输出Loaded SQL script from class path resource [data.sql]，验证文件是否被成功加载
  • 检查是否存在SQL执行错误（如“表不存在”“约束违反”等），这类错误会直接导致数据插入失败

6. 备选方案：代码中手动初始化数据 #

若以上方法均无效，可通过@PostConstruct注解在Repository中手动插入初始化数据，示例代码：

@Repository
public interface UserRepository extends JpaRepository<User, Long> {

    @PostConstruct
    default void initData() {
        save(new User("test1@example.com", "Test User1"));
        save(new User("test2@example.com", "Test User2"));
    }
}

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