Spring Boot中Liquibase命令行更新报错及参数不生效问题

问题根源 #

mvn liquibase:update 调用的是Liquibase官方Maven插件，而非Spring Boot的自动配置逻辑，因此存在两个核心问题：

1. 插件不识别Spring的classpath:协议，会将其作为普通文件路径的一部分处理，Windows系统中冒号:是非法路径字符，直接触发InvalidPathException。
2. Spring相关的参数（如-Dspring.liquibase.change-log）对该插件完全无效，插件只会读取自身配置或专用参数，导致你设置的路径参数被忽略。

解决方案一：配置Liquibase Maven插件 #

在项目pom.xml中添加或修改Liquibase插件配置，直接指定数据库连接和变更日志的本地路径：

<build>
    <plugins>
        <plugin>
            <groupId>org.liquibase</groupId>
            <artifactId>liquibase-maven-plugin</artifactId>
            <!-- 建议与Spring Boot依赖的Liquibase版本保持一致 -->
            <version>4.24.0</version>
            <configuration>
                <!-- 数据库连接信息 -->
                <url>jdbc:sqlserver://localhost\SQLEXPRESS:1433;...</url>
                <username>你的数据库用户名</username>
                <password>你的数据库密码</password>
                <defaultSchemaName>dbo</defaultSchemaName>
                <!-- 变更日志路径：直接指向src/main/resources下的文件 -->
                <changeLogFile>src/main/resources/db/changelog/db.changelog-master.yaml</changeLogFile>
            </configuration>
        </plugin>
    </plugins>
</build>

配置完成后，直接执行mvn liquibase:update即可正常运行。

解决方案二：命令行指定插件参数 #

若不想修改pom.xml，可通过Liquibase插件的专用参数在命令行直接指定配置，注意参数名和路径格式：

mvn liquibase:update 
  -Dliquibase.changeLogFile=src/main/resources/db/changelog/db.changelog-master.yaml 
  -Dliquibase.url=jdbc:sqlserver://localhost\SQLEXPRESS:1433;... 
  -Dliquibase.username=你的用户名 
  -Dliquibase.password=你的密码

这里必须使用插件专用参数liquibase.changeLogFile，Spring相关参数对插件不生效。

额外调整建议 #

• 变更日志中的文件路径：将relativeToChangelogFile设为true，这样路径可以相对于当前changelog文件所在目录（db/changelog）编写，无需写绝对路径，例如：

  databaseChangeLog:
    - include:
        file: 001-changelog-1.0.sql
        relativeToChangelogFile: true
    - changeSet:
        id: 3
        author: amitthakur
        changes:
          - sqlFile:
              path: 001-create-table-user.sql
              dbms: mssql
              relativeToChangelogFile: true
  

• 版本一致性：确保Liquibase Maven插件版本与Spring Boot依赖的Liquibase版本一致，避免兼容性问题。

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