Gradle迁移：如何在build.gradle.kts中正确定义变量？

错误原因 #

你碰到的空指针问题，是因为当环境变量未设置时，System.getenv("XXX")返回null，而Kotlin作为强类型语言，不允许对null值调用toString()（Groovy会自动把null转为空字符串，但Kotlin不会做这种隐式处理）。

正确实现方案 #

方案1：处理null值，直接在ext块定义变量

无需提前声明变量，直接在ext块内获取环境变量并处理null情况，用Elvis运算符?:给默认值：

ext {
    val dbUsername = System.getenv("DB_USER") ?: ""
    val dbPassword = System.getenv("DB_PASS") ?: ""
    val libsUserNameNew = System.getenv("LIBS_USERNAME_NEW") ?: ""
    val libsPassNew = System.getenv("LIBS_PASS_NEW") ?: ""
    val gitShortTag = System.getenv("SHORT_SHA") ?: ""
    val repoName = System.getenv("REPO_NAME") ?: ""
    group = "app.test.mms"
    mainClass = "app.test.customerservicepoc.CustomerServicePOC"
}

方案2：使用Gradle官方推荐的Providers API（更安全高效）

Gradle提供的providers.environmentVariable()支持延迟解析和默认值，更贴合Gradle的构建生命周期，还能避免配置阶段的不必要计算：

// 定义全局变量，可在整个构建脚本中使用
val dbUsername by providers.environmentVariable("DB_USER").forUseAtConfigurationTime().orElse("")
val dbPassword by providers.environmentVariable("DB_PASS").forUseAtConfigurationTime().orElse("")
val libsUserNameNew by providers.environmentVariable("LIBS_USERNAME_NEW").forUseAtConfigurationTime().orElse("")
val libsPassNew by providers.environmentVariable("LIBS_PASS_NEW").forUseAtConfigurationTime().orElse("")
val gitShortTag by providers.environmentVariable("SHORT_SHA").forUseAtConfigurationTime().orElse("")
val repoName by providers.environmentVariable("REPO_NAME").forUseAtConfigurationTime().orElse("")

// 配置项目属性
group = "app.test.mms"
application {
    mainClass.set("app.test.customerservicepoc.CustomerServicePOC")
}

如果是Java/Spring Boot项目，mainClass建议放在application块内配置，这是Kotlin DSL的标准写法。

方案3：多模块项目全局共享变量

如果需要在子项目中共享这些变量，在根项目的build.gradle.kts中这样定义：

allprojects {
    extra["dbUsername"] = System.getenv("DB_USER") ?: ""
    extra["dbPassword"] = System.getenv("DB_PASS") ?: ""
    // 其他变量同理
    group = "app.test.mms"
}

子项目中可以通过val dbUsername by extra或者project.extra["dbUsername"]来获取变量值。

关键注意点 #

• Kotlin不允许隐式处理null，必须显式用?:或其他方式处理环境变量不存在的情况
• 优先使用Gradle的Providers API，而非直接调用System.getenv()，能提升构建效率并避免潜在的配置阶段问题
• 不要像Groovy那样提前声明空字符串变量再赋值，Kotlin DSL中直接在ext块或顶层定义变量即可

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