IntelliJ中Load Gradle Changes的环境变量配置与Gradle凭证外部化问题

我正在开发一个使用gradle脚本构建、IntelliJ作为开发IDE的Spring Boot项目。希望将Artifactory的用户名/密码从build.gradle和gradle.properties中外部化处理，采用Gradle文档中「Setting a project property via an environment variable」章节所述的环境变量方式。

已成功在build等任务配置中访问这些变量，但修改build.gradle后点击Load Gradle Changes时出现错误：

Exception is:
org.gradle.api.GradleScriptException: A problem occurred evaluating root project.

Caused by: groovy.lang.MissingPropertyException: Could not get unknown property 'password' for root project

问题 #

1. 点击Load Gradle Changes时会运行哪个Gradle任务？以便为该任务配置环境变量。
2. 如何在单一位置添加这些变量，而非为每个任务单独配置？

配置信息 #

• IntelliJ IDEA 2021.3.1 (旗舰版)
• Gradle 7.2
• 构建时间: 2021-08-17 09:59:03 UTC
• 版本修订: a773786b58bb28710e3dc96c4d1a7063628952ad
• Kotlin: 1.5.21
• Groovy: 3.0.8
• Ant: Apache Ant(TM) 版本 1.10.9，编译于2020年9月27日
• JVM: 11.0.2 (Oracle Corporation 11.0.2+9)

问题1解答 #

点击Load Gradle Changes时，IntelliJ并未运行具体的Gradle任务，而是触发了Gradle的配置阶段（Configuration Phase）。这个阶段会执行所有构建脚本（build.gradle、settings.gradle）中的配置代码，用于解析项目结构、任务依赖关系等，但不会执行任务的实际运行逻辑。你遇到的错误正是因为配置阶段尝试读取未定义的password属性，而对应的环境变量未在该阶段生效。

问题2解答 #

以下是几种在单一位置统一配置变量的可靠方式：

方式1：通过gradle.properties映射环境变量 #

在项目根目录的gradle.properties中添加以下配置，用环境变量覆盖默认空值，避免属性不存在的异常：

artifactoryUsername=${env.ARTIFACTORY_USERNAME:}
artifactoryPassword=${env.ARTIFACTORY_PASSWORD:}

之后在build.gradle中直接使用artifactoryUsername和artifactoryPassword即可，Gradle会自动优先读取环境变量，环境变量不存在时使用默认空字符串。

方式2：在settings.gradle中全局加载属性 #

在settings.gradle中添加代码，提前加载环境变量并设置为项目全局属性，确保在build.gradle解析前属性已定义：

rootProject.ext {
    artifactoryUsername = System.getenv('ARTIFACTORY_USERNAME') ?: ''
    artifactoryPassword = System.getenv('ARTIFACTORY_PASSWORD') ?: ''
}

整个项目（包括所有子项目）都可以通过project.artifactoryUsername访问这些属性。

方式3：配置IntelliJ的Gradle环境变量 #

如果仅需在IDE内解决问题，可以直接给IntelliJ的Gradle进程添加环境变量：

1. 打开File > Settings > Build, Execution, Deployment > Build Tools > Gradle
2. 在Gradle JVM下方的Environment variables中添加ARTIFACTORY_USERNAME和ARTIFACTORY_PASSWORD
3. 点击Apply保存，后续Load Gradle Changes时会自动带上这些环境变量

内容的提问来源于stack exchange，提问作者Harish Kumar Saini