Spring Boot中Liquibase无法解析application.properties参数至变更集

1. 两类参数的处理逻辑完全独立 #

Liquibase在Spring Boot环境下存在两套独立的参数处理体系：

• 数据库连接参数：Spring Boot会将application.properties中的spring.datasource.*配置直接注入到Liquibase的数据库连接组件中，这属于Spring层面的属性传递，和Liquibase自身的变更日志变量解析系统无直接关联，因此哪怕使用非标准端口5434也能正常完成数据库连接。
• 变更集内的变量解析：<executeCommand>指令里的${password}、${port}这类变量，由Liquibase专属的变更日志变量系统负责解析，该系统仅识别以下来源的变量：
  • 变更日志顶部通过<property>标签定义的变量
  • Liquibase命令行传入的参数
  • 系统环境变量
  • 独立的liquibase.properties配置文件中的参数
    Spring Boot的application.properties中的属性，若未显式映射到该系统，无法被变更集指令读取。

2. liquibase.port无效的本质原因 #

在application.properties中添加liquibase.port=5434无效，是因为Spring Boot仅将liquibase.*前缀的属性用于配置Liquibase的基础运行参数（如变更日志路径、执行上下文等），不会自动将这些属性转换为变更集可引用的变量。

3. 手动添加<property>有效的原因 #

在变更日志顶部手动添加<property>标签，相当于直接在Liquibase的变更日志变量池中注册了对应变量，<executeCommand>执行时可以直接从该池中读取参数，因此能正常完成解析。

内容的提问来源于stack exchange，提问作者Marc Le Bihan