如何在执行Gradle构建时通过命令行传递数据库配置参数

API 探路者

2026-9-26

Gradle构建时命令行传递数据库参数实现方案

1. 配置Gradle资源替换规则

首先需要在build.gradle中开启占位符替换能力，让Gradle在编译打包阶段自动将application.properties中的变量替换为命令行传入的参数值。

Groovy语法（build.gradle）配置：

processResources {
    filesMatching("application.properties") {
        expand(project.properties)
    }
}

Kotlin DSL（build.gradle.kts）配置：

tasks.processResources {
    filesMatching("application.properties") {
        expand(project.properties)
    }
}

2. 配置application.properties占位符

你原有配置不需要大幅修改，直接保留占位符即可，示例如下：

spring.datasource.url=jdbc:postgresql://${db_server}:${db_port}/${db_database}
spring.datasource.username=${db_username}
spring.datasource.password=${db_password}

提示：如果你的数据库端口固定为5432，也可以把配置中的${db_port}直接写死为5432，不需要从命令行传该参数。

3. 执行构建命令传参

直接使用你给出的传参格式执行构建即可：

gradle build -Pdb_server=实际数据库地址 -Pdb_port=实际端口 -Pdb_database=实际库名 -Pdb_username=登录账号 -Pdb_password=登录密码

可选配置：添加参数默认值

如果希望不传对应参数时不会构建报错，可以在build.gradle中为每个参数配置默认值，Groovy版本示例如下：

ext {
    db_server = project.hasProperty('db_server') ? db_server : 'localhost'
    db_port = project.hasProperty('db_port') ? db_port : '5432'
    db_database = project.hasProperty('db_database') ? db_database : 'default_db'
    db_username = project.hasProperty('db_username') ? db_username : 'postgres'
    db_password = project.hasProperty('db_password') ? db_password : ''
}

processResources {
    filesMatching("application.properties") {
        expand(project.properties)
    }
}