为什么 liquibase 无法解析 db.changelog 类路径？

Question

这是maven依赖jar项目的结构之一，其中一个包含类路径中的liquibase更改日志如下：

chorke?init?change-1.0.00.GA.jar!
 ?? META-INF/
    ?? migrations/
        ?? db.changelog-master.xml
        ?? config/
        ?   ?? db.changelog-config.xml
        ?   ?? db.changelog-property.xml
        ?   ?? db.changelog-restrict.xml
        ?? change/
            ?? db.changelog-1.xml
            ?? db.changelog-2.xml
            ?? V1/
            ?   ?? db.changelog-1.0.xml
            ?   ?? db.changelog-1.1.xml
            ?   ?? V1.0/
            ?   ?   ?? db.changelog-1.0.00.xml
            ?   ?   ?? db.changelog-1.0.01.xml
            ?   ?   ?? V1.0.00/
            ?   ?   ?   ?? db.changelog-1.0.00.000.xml
            ?   ?   ?   ?? db.changelog-1.0.00.001.xml
            ?   ?   ?   ?? db.changelog-1.0.00.002.xml
            ?   ?   ?   ?? db.changelog-1.0.00.999.xml
            ?   ?   ?? V1.0.01/
            ?   ?       ?? db.changelog-1.0.01.000.xml
            ?   ?       ?? db.changelog-1.0.01.001.xml
            ?   ?       ?? db.changelog-1.0.01.002.xml
            ?   ?       ?? db.changelog-1.0.01.999.xml
            ?   ?? V1.1/
            ?       ?? db.changelog-1.1.00.xml
            ?       ?? db.changelog-1.1.01.xml
            ?       ?? V1.1.00/db.changelog-1.1.00.###.xml
            ?       ?? V1.1.01/db.changelog-1.1.01.###.xml
            ?? V2/
                ?? db.changelog-2.#.xml
                ?? V2.#/V2.#.##/db.changelog-2.#.##.###.xml

这是db.changelog-master.xml

<?xml version="1.0" encoding="UTF-8"?>
<databaseChangeLog xmlns="http://www.liquibase.org/xml/ns/dbchangelog"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:ext="http://www.liquibase.org/xml/ns/dbchangelog-ext"
    xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-3.5.xsd
    http://www.liquibase.org/xml/ns/dbchangelog-ext http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-ext.xsd">

    <includeAll path="config" relativeToChangelogFile="true"/>
    <include file="change/db.changelog-1.xml" relativeToChangelogFile="true"/>
    <include file="change/db.changelog-2.xml" relativeToChangelogFile="true"/>
</databaseChangeLog>

spring-boot 加载的哪一个application.properties如下

liquibase.change-log=classpath:/META-INF/migrations/db.changelog-master.xml

当它在同一个项目中时执行得很好。在依赖项目上，它执行如下：

1. 已创建DATABASECHANGELOG表
2. 已创建DATABASECHANGELOGLOCK表
3. 但是没有执行更新迁移！

当liquibase maven 插件加载db.changelog-master.xml如下：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <!-- intentionally configuration skipped -->
    <dependencies>
        <dependency>
            <groupId>org.chorke.init</groupId>
            <artifactId>chorke-init-change</artifactId>
            <version>1.0.00.GA</version>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.liquibase</groupId>
                <artifactId>liquibase-maven-plugin</artifactId>
                <version>3.5.3</version>
                <configuration>
                    <propertyFileWillOverride>true</propertyFileWillOverride>
                    <promptOnNonLocalDatabase>false</promptOnNonLocalDatabase>
                    <changeLogFile>classpath:/META-INF/migrations/db.changelog-master.xml</changeLogFile>
                    <propertyFile>${project.build.directory}/test-classes/liquibase-update.properties</propertyFile>
                </configuration>
                <executions>
                    <execution>
                        <phase>package</phase>
                        <goals>
                            <goal>update</goal>
                        </goals>
                    </execution>
                </executions>
                <dependencies>
                    <dependency>
                        <groupId>org.yaml</groupId>
                        <artifactId>snakeyaml</artifactId>
                        <version>1.14</version>
                    </dependency>
                </dependencies>
            </plugin>
        </plugins>
    </build>
</project>

消息错误：

Failed to execute goal
org.liquibase:liquibase-maven-plugin:3.5.3:update (default) on project
chorke-init-migrat: Error setting up or running Liquibase:
classpath:/META-INF/migrations/db.changelog-master.xml does not exist

在这种情况下，您的指南期望为使用spring-boot或liquibase-maven-plugin的依赖项目进行无错误的liquibase 迁移

Answer 1

所提到的结构chorke?init?change-1.0.00.GA.jar包含liquibase更改日志中的类路径是不够好和春季启动 application.properties也正是配置。但是liquibase-maven-plugin配置中出现了一些愚蠢的错误，应更正如下：

<configuration>
    <propertyFileWillOverride>true</propertyFileWillOverride>
    <promptOnNonLocalDatabase>false</promptOnNonLocalDatabase>
    <changeLogFile>META-INF/migrations/db.changelog-master.xml</changeLogFile>
    <propertyFile>liquibase-update.properties</propertyFile>
</configuration>

liquibase-maven-plugin配置中有两个错误：

1. 第一个为 changeLogFile
2. 第二个为 propertyFile

无需使用前缀 likeclasspath:或classpath:/for changeLogFile，也无需使用${project.build.directory}/test-classes/for之类的绝对或相对路径propertyFile。保持简单。这是自己的业务liquibase - Maven的插件如何从解决它classpath。

除此之外，还有一些额外的提示可能有助于轻松的便携式迁移，如下所示

1. 始终对每个databaseChangeLog. 您的db.changelog-master.xml 中提到了示例
2. 为每个使用逻辑文件路径 changeSet

以下是逻辑文件路径的示例：

<changeSet author="chorkeorg" id="1508234245316-1" logicalFilePath="V0/V0.0/V0.0.00/db.changelog-0.0.00.000.xml">
    <createSequence cacheSize="20" cycle="false"
        incrementBy="1" maxValue="999999999999999999999999999" minValue="10001"
        ordered="false" sequenceName="CK_SQ_AUTHOR" startValue="10181" />
</changeSet>

希望它能正确解决您的问题。