能否在Liquibase properties文件中指定占位符的参数值？

Liquibase 4.11.0 原生支持在properties配置文件中定义SQL changelog内的占位符参数，配置不生效的核心原因通常是未按规则给参数加指定前缀。

配置规则 #

Liquibase不会直接识别properties文件中裸写的自定义参数名，所有要替换到changelog（含SQL格式changelog）里的自定义参数，必须以parameter.作为配置前缀，后缀为占位符的实际名称。

正确配置示例 #

liquibase.properties文件

保留原有数据库连接、changelog路径等基础配置，按前缀规则新增占位符参数即可：

# 原有基础数据库配置（替换为你实际环境的取值）
driver: org.postgresql.Driver
url: jdbc:postgresql://127.0.0.1:5432/your_db
username: db_admin
password: db_password
changeLogFile: src/main/resources/liquibase/changelog.sql

# 自定义占位符配置（核心配置）
parameter.rolename: therole

Maven插件配套配置

通过Maven运行Liquibase时，需要确认pom.xml中liquibase-maven-plugin正确关联了properties文件路径，避免配置读取失败：

<plugin>
    <groupId>org.liquibase</groupId>
    <artifactId>liquibase-maven-plugin</artifactId>
    <version>4.11.0</version>
    <configuration>
        <!-- 按liquibase.properties实际存放路径填写，默认读取项目根目录下的同名文件 -->
        <propertyFile>src/main/resources/liquibase.properties</propertyFile>
    </configuration>
</plugin>

补充说明 #

• 参数优先级：命令行通过-D传入的参数优先级高于properties文件中的同名配置，原有mvn -Drolename=therole的传参方式依然有效，可用于覆盖不同部署环境的默认取值
• 现有SQL文件中${rolename}的占位符写法完全符合Liquibase默认替换规则，无需调整SQL内容
• 配置完成后直接执行mvn liquibase:update即可自动完成占位符替换，无需额外传入参数

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