Spring Boot集成Liquibase：SQL变更日志文件层级配置问询

我之前也碰到过一模一样的问题，其实Liquibase的纯SQL格式是支持通过主变更日志文件来引入其他子SQL文件的，只是官方文档里这块的说明比较零散。下面是具体的实现步骤：

1. 创建主变更日志文件 #

首先在你的资源目录（比如src/main/resources/db/changelog/）下创建一个主文件，命名为master-changelog.sql。这个文件的作用是作为入口，统一引入所有子SQL变更文件。

文件内容需要以Liquibase的格式化注释开头，然后用--include指令逐个引入子文件：

--liquibase formatted sql

-- 按版本/模块组织子文件，relativeToChangelogFile=true表示路径相对于当前主文件
--include file:v1/init-users.sql relativeToChangelogFile:true
--include file:v1/init-products.sql relativeToChangelogFile:true
--include file:v2/add-order-table.sql relativeToChangelogFile:true
--include file:modules/payment/init-payment.sql relativeToChangelogFile:true

关键参数说明：relativeToChangelogFile=true 是必须的，它告诉Liquibase子文件的路径是相对于主变更日志文件的位置，避免因绝对路径导致的文件找不到问题。

2. 编写子SQL变更文件 #

每个子SQL文件同样需要以--liquibase formatted sql开头，并且必须包含--changeset指令（Liquibase通过这个指令跟踪每个变更的执行记录）。比如v1/init-users.sql的内容：

--liquibase formatted sql

--changeset your-name:1
CREATE TABLE users (
    id BIGINT PRIMARY KEY AUTO_INCREMENT,
    username VARCHAR(50) NOT NULL UNIQUE,
    email VARCHAR(100) NOT NULL UNIQUE
);

--rollback DROP TABLE users;

你可以根据版本号、业务模块来划分目录（比如v1/、v2/、modules/payment/），轻松管理大量初始化SQL文件。

3. 配置Spring Boot指向主文件 #

在application.properties或application.yml中，只需要配置主变更日志文件的路径即可：

application.properties #

spring.liquibase.change-log=classpath:db/changelog/master-changelog.sql

application.yml #

spring:
  liquibase:
    change-log: classpath:db/changelog/master-changelog.sql

重要注意事项 #

• Spring Boot的Liquibase Starter不支持用逗号或分号分隔多个变更日志文件路径，这就是你之前报错的原因，必须通过主文件引入的方式实现层级结构。
• 每个子文件必须包含至少一个--changeset指令，否则Liquibase会忽略该文件的内容。
• 可以在--include指令中添加context、label等参数，实现按环境或标签执行特定变更。

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