如何通过命令行参数向Gradle Liquibase Update任务传递数据库参数

我明白你遇到的问题了——直接用--url这种格式传参数会报错，因为Gradle把--开头的选项当作内置命令行参数，不识别自定义的数据库连接参数。咱们换用Gradle的**项目属性（Project Properties）**来传递就可以解决这个问题，具体步骤如下：

第一步：修改build.gradle配置，让Liquibase读取项目属性 #

在你的Liquibase插件配置块中，把url、username、password替换为读取Gradle项目属性的逻辑，这样就能接收命令行传入的值了。示例配置如下：

liquibase {
    activities {
        main {
            // 从项目属性中读取参数，没有传入时可留空或设置默认值（按需调整）
            url project.findProperty('url') ?: ''
            username project.findProperty('username') ?: ''
            password project.findProperty('password') ?: ''
            // 其他Liquibase基础配置，比如变更日志文件路径
            changeLogFile 'src/main/resources/db/changelog/db.changelog-master.xml'
        }
    }
    runList = project.findProperty('runList') ?: 'main'
}

如果希望强制要求这些参数必须传入（避免遗漏导致运行失败），可以添加参数校验逻辑：

// 在build.gradle中添加这段代码，用于校验update任务的必填参数
gradle.taskGraph.whenReady { graph ->
    if (graph.hasTask(':update')) {
        def requiredProps = ['url', 'username', 'password']
        requiredProps.each { prop ->
            if (!project.hasProperty(prop)) {
                throw new GradleException("必须通过命令行传入-${prop}参数，格式为-P${prop}=xxx")
            }
        }
    }
}

第二步：使用正确的命令行格式执行任务 #

现在用-P前缀来传递自定义参数，这是Gradle识别项目属性的标准方式。正确的执行命令如下：

gradle update -Purl=jdbc:postgresql://localhost:5432/liquibase_cmd_test -Pusername=your_db_username -Ppassword=your_db_password -PrunList=main

这样Gradle就能把这些参数传递给Liquibase插件，update任务就能正常连接数据库执行变更了。

补充说明 #

• 为什么之前的--url会报错？因为Gradle的命令行语法中，--开头的是内置系统选项（比如--info、--dry-run），自定义参数必须用-P前缀声明为项目属性。
• 如果担心密码明文泄露，可以结合--no-build-cache避免Gradle缓存敏感信息，或者使用Gradle的凭证管理插件来更安全地处理密码，但临时测试场景下，直接用-Ppassword是最便捷的方式。

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