Spring Boot+Liquibase+H2建表遇循环依赖错误求助

核心排查与修复方案 #

1. 禁用自定义Liquibase配置，改用Spring Boot自动配置 #

若你编写了自定义的Liquibase配置类，大概率是它打破了Spring Boot默认的依赖顺序，引发循环依赖。直接移除该配置类，通过application.properties/yml配置Liquibase即可：

spring.liquibase.change-log=classpath:db/changelog/db.changelog-master.xml
spring.liquibase.enabled=true

2. 调整JPA初始化时机 #

让JPA的EntityManagerFactory延迟到Liquibase完成数据库迁移后再初始化，添加以下配置：

spring.jpa.defer-datasource-initialization=true

3. 关闭Hibernate自动DDL #

同时启用Liquibase和Hibernate自动DDL会导致冲突，进而触发循环依赖错误，需完全禁用Hibernate的DDL管理：

spring.jpa.hibernate.ddl-auto=none

4. 检查依赖版本兼容性 #

确保使用Spring Boot官方的Liquibase starter，避免手动引入的liquibase-core与Spring Boot版本不兼容：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-liquibase</artifactId>
</dependency>

移除任何单独引入的liquibase-core依赖。

5. 验证实体类与迁移脚本一致性 #

实体类的@Table、@Column等注解定义的结构，必须和Liquibase迁移脚本创建的表结构完全匹配。结构不匹配会导致EntityManagerFactory初始化失败，进而触发循环依赖的错误提示（本质是底层错误的连锁反应）。

正确配置示例（application.properties） #

# H2数据库配置
spring.datasource.url=jdbc:h2:mem:testdb
spring.datasource.driverClassName=org.h2.Driver
spring.datasource.username=sa
spring.datasource.password=

# Liquibase配置
spring.liquibase.change-log=classpath:db/changelog/db.changelog-master.xml
spring.liquibase.enabled=true

# JPA配置
spring.jpa.hibernate.ddl-auto=none
spring.jpa.show-sql=true
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.H2Dialect
spring.jpa.defer-datasource-initialization=true

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