为啥 liquibase 无法解析 db.changelog 类路径?

Posted

技术标签:

【中文标题】为啥 liquibase 无法解析 db.changelog 类路径?【英文标题】:Why liquibase unable to resolved the db.changelog classpath?为什么 liquibase 无法解析 db.changelog 类路径? 【发布时间】:2018-03-30 08:37:19 【问题描述】:

这是maven依赖jar项目之一的结构,其中一个包含liquibaseclasspath中的更改日志如下:

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-bootapplication.properties如下加载哪一个

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

在同一个项目中执行得很好。在依赖项目上执行如下:

    DATABASECHANGELOG 表已创建 DATABASECHANGELOGLOCK 表已创建 但没有执行更新迁移

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-bootliquibase-maven-plugin 的依赖项目提供无错误 liquibase 迁移 >

【问题讨论】:

【参考方案1】:

chorke─init─change-1.0.00.GA.jar 提到的结构在 classpath 中包含 liquibase 更改日志 已经足够好,并且 spring-boot 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 配置中有两个错误:

    changeLogFile 的第一个 第二个为propertyFile

changeLogFile不需要使用classpath:classpath:/等前缀,propertyFile也不需要使用$project.build.directory/test-classes/等绝对或相对路径。让它简单。如何从classpath解决是liquibase-maven-plugin自己的事。

除此之外,还有一些其他提示可能有助于轻松进行便携式迁移,如下所示

    始终为每个databaseChangeLog 使用相对路径。您的 db.changelog-master.xml 中提到了示例 为每个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>

希望它能妥善解决您的问题。

【讨论】:

以上是关于为啥 liquibase 无法解析 db.changelog 类路径?的主要内容,如果未能解决你的问题,请参考以下文章

为啥我的 liquibase modifySQL 子句没有被触发?

LiquiBase 问题,类路径资源 [db/changelog/db.changelog-master.yaml] 无法解析为 URL,因为它不存在

无法使用Liquibase标记数据库以备将来回滚

为啥 liquibase 总是使用自己的序列?

Liquibase Maven 无法读取 changeLogFile

无法与 liquibase gradle 插件生成差异