Spring Data JPA与Liquibase的正确配置组合方案咨询

当同时使用Spring Data JPA和Liquibase时，核心原则是让Liquibase作为唯一的数据库结构版本管理工具，Hibernate仅负责实体与数据库结构的验证，避免多工具同时操作数据库导致冲突。以下是不同场景下的正确配置组合：

通用基础配置（全环境适用） #

不管是开发、测试还是生产环境，都需要确保Hibernate不修改数据库结构，同时启用Liquibase的版本管控：

# 禁用旧版Spring Boot初始化配置（Spring Boot 2.5+可直接删除该配置）
spring.datasource.initialize=false

# Hibernate仅验证实体与数据库表结构是否匹配，不生成/修改DDL
spring.jpa.hibernate.ddl-auto=validate

# 启用Liquibase并指定主变更日志文件
spring.liquibase.enabled=true
spring.liquibase.change-log=classpath:db/changelog/db.changelog-master.xml

分环境配置Spring SQL初始化 #

Spring Boot的SQL初始化（执行schema.sql/data.sql）需根据环境按需启用：

开发/测试环境 #

如果需要用data.sql快速初始化测试数据（注意不要和Liquibase的数据变更集重复），可设置：

# 每次启动都执行SQL初始化脚本
spring.sql.init.mode=always
# 或仅在使用嵌入式数据库（如H2）时执行
# spring.sql.init.mode=embedded

注意：若Liquibase已包含表结构创建语句，请勿使用schema.sql，避免重复建表报错。

生产环境 #

必须禁用Spring Boot自带的SQL初始化，防止意外执行脚本修改数据库：

spring.sql.init.mode=never

旧版Spring Boot（2.4及以下）适配 #

对于2.4及以下版本的Spring Boot，需用旧版初始化配置替代spring.sql.init.mode：

# 生产环境设为never，开发环境设为always/embedded
spring.datasource.initialization-mode=never

# 其余配置与通用基础配置一致
spring.datasource.initialize=false
spring.jpa.hibernate.ddl-auto=validate
spring.liquibase.enabled=true
spring.liquibase.change-log=classpath:db/changelog/db.changelog-master.xml

关键注意事项 #

• 禁止将spring.jpa.hibernate.ddl-auto设为create/create-drop/update，否则Hibernate会直接修改数据库结构，与Liquibase的版本管理冲突，导致结构不一致。
• 所有数据库结构变更（建表、改字段、加索引等）必须写入Liquibase的变更日志，确保结构完全由Liquibase管控。
• 若同时使用Spring Boot的data.sql和Liquibase的数据初始化，需避免数据重复插入，比如给Liquibase变更集设置runOnChange属性，或仅保留一种数据初始化方式。

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