Liquibase如何参数化连接URL中的数据库名实现动态传参

我的Liquibase属性文件配置如下：

driver: com.microsoft.sqlserver.jdbc.SQLServerDriver
classpath: C:\\Program Files\\sqljdbc_10.2\\enu\\mssql-jdbc-10.2.1.jre17.jar
changeLogFile: .\\home_changeLog.xml
url: jdbc:sqlserver://localhost;databaseName=home;integratedSecurity=false;trustServerCertificate=true;
username: user
password: password123
liquibase.hub.mode=off

我希望对连接URL中使用的数据库名进行参数化配置，尝试将URL修改为如下形式：

url: jdbc:sqlserver://localhost;databaseName=${database};integratedSecurity=false;trustServerCertificate=true;

当我执行以下命令时：

liquibase --defaults-file="Home.properties"  updatesql -database="home2"

Liquibase抛出如下错误：

运行Liquibase时发生意外错误：无法创建指向jdbc:sqlserver://localhost;databaseName=${database};integratedSecurity=false;trustServerCertificate=true;的数据库连接，使用的驱动为com.microsoft.sqlserver.jdbc.SQLServerDriver。连接字符串包含格式错误的名称或值。

如果我执行如下带双横杠参数的命令：

liquibase --defaults-file="Home.properties"  updatesql --database="home2"

返回错误：

意外参数：--database=home2

需求：实现URL中数据库名的参数化配置，复用同一份changelog文件，无需为每个环境单独准备不同的changelog文件。

报错核心原因有两个：

• Liquibase属性文件中的${xxx}格式占位符，不会自动识别命令行中随意传入的-xxx或--xxx格式参数，必须通过固定格式传入自定义参数才会触发替换
• database不是Liquibase内置的命令行长/短参数，直接传入会被判定为非法参数

具体实现步骤如下：

• 保留属性文件中的占位符配置，建议将占位符命名调整为避开内置关键字的名称，同时开启属性替换开关（部分老版本Liquibase默认关闭），注意：不要使用Liquibase内置参数名作为自定义占位符名称，避免参数冲突导致配置不生效，最终属性文件参考配置：

driver: com.microsoft.sqlserver.jdbc.SQLServerDriver
classpath: C:\\Program Files\\sqljdbc_10.2\\enu\\mssql-jdbc-10.2.1.jre17.jar
changeLogFile: .\\home_changeLog.xml
url: jdbc:sqlserver://localhost;databaseName=${targetDbName};integratedSecurity=false;trustServerCertificate=true;
username: user
password: password123
liquibase.hub.mode=off
# 开启属性占位符替换，兼容老版本
liquibase.enable-property-substitution=true

• 执行命令时，自定义参数必须以-D前缀传入，格式为-D参数名=参数值，正确命令示例：

liquibase --defaults-file="Home.properties" updatesql -DtargetDbName="home2"

其他可选实现方式 #

如果不想每次在命令行传参，也可以通过多环境配置文件实现：

• 新建不同环境的独立属性文件，比如dev.properties、prod.properties，里面只配置对应环境的数据库名或完整url，公共配置保留在主Home.properties中
• 在主属性文件中通过include指令引入对应环境的配置文件，执行时只需要切换引入的环境文件即可，全程不需要修改changelog文件。

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