如何整理已应用的Liquibase脚本至年份子目录且避免重复执行？

我在单个changelogs目录下存有大量已执行的Liquibase脚本，该目录目前过于庞大。我希望按年份创建changelogs/2014、changelogs/2015等子目录来归类脚本，但移动脚本后Liquibase会尝试重新执行这些脚本，请问有什么解决办法？我已尝试使用<includeAll path="changelogs/2014" />和<include file="changelogs/2014/changelog-2014.xml" />。

解决办法 #

Liquibase判断脚本是否已执行的核心依据是databasechangelog表中的filepath字段，移动脚本后物理路径改变，Liquibase会判定为新脚本，因此需要同步调整该字段或解绑物理路径与逻辑标识：

1. 批量更新databasechangelog表的路径记录 #

直接通过SQL修改filepath字段，将旧路径替换为新的分类路径：

-- 示例：将2014年的脚本路径从changelogs/xxx.xml改为changelogs/2014/xxx.xml
UPDATE databasechangelog 
SET filepath = REPLACE(filepath, 'changelogs/', 'changelogs/2014/') 
WHERE filepath LIKE 'changelogs/2014-%'; -- 根据你的脚本命名规则调整匹配条件

注意：执行前务必备份数据库，避免误操作导致数据异常。

2. 为脚本添加logicalFilePath属性（长期最优方案） #

给每个changelog文件添加logicalFilePath属性，指定一个固定的逻辑路径，让Liquibase不再依赖物理路径判断：

<databaseChangeLog xmlns="http://www.liquibase.org/xml/ns/dbchangelog"
                   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                   xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog
                   http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-4.9.xsd"
                   logicalFilePath="changelogs/changelog-2014.xml"> <!-- 填写脚本原来的路径作为固定标识 -->
    <!-- 你的changeSet内容 -->
</databaseChangeLog>

添加后执行一次Liquibase的update命令，系统会自动将databasechangelog表中的filepath更新为你指定的逻辑路径，后续无论物理文件移到哪个目录，都不会重复执行。

3. 用路径变量优化后续分类管理 #

如果后续还要新增年份分类，可以在主changelog中定义路径变量，方便统一管理：

<property name="year2014Path" value="changelogs/2014" />
<includeAll path="${year2014Path}" />

但此方法仅对新增脚本生效，已移动的旧脚本仍需通过前两种方法处理路径匹配问题。

内容的提问来源于stack exchange，提问作者Žeka Koževin