Gradle 7.6.4在IntelliJ中无法读取gradle.properties文件的问题

问题背景 #

• 新笔记本电脑在IntelliJ中配置Gradle 7.6.4时出现异常，旧电脑配置无问题
• 全局Gradle配置文件C:\Users\username\.gradle\gradle.properties已配置：

  artifactory_user=user
  artifactory_password=pass
  artifactory_contextUrl=url
  

• 导入现有Gradle项目时触发错误：

  Could not get unknown property ‘artifactoryUser’ for settings ‘projectname’ of type org.gradle.initialization.DefaultSettings.

• 尝试硬编码用户名密码后，build.gradle首行插件无法下载
• 测试读取属性返回null：

  println(settings.hasProperty(‘artifactory_password’) ? settings.artifactory_password : ‘’)
  println(hasProperty(‘artifactory_user’) ? artifactory_user : ‘’)
  

解决步骤 #

1. 修正属性名匹配问题 #

报错提示找不到artifactoryUser，但配置文件中使用的是下划线命名artifactory_user，Gradle属性名大小写敏感，且不会自动转换下划线与驼峰格式。需二选一修改：

• 把全局gradle.properties中的键改为驼峰格式：artifactoryUser=user、artifactoryPassword=pass
• 或把项目代码中引用的属性名改为下划线格式，比如将artifactoryUser替换为artifactory_user

2. 确认全局配置文件加载路径 #

打开IntelliJ的File > Settings > Build, Execution, Deployment > Build Tools > Gradle，检查Gradle user home是否指向C:\Users\username\.gradle。若路径被修改，全局配置文件不会被加载，需改回正确路径。

同时检查项目根目录或gradle子目录下是否存在本地gradle.properties文件，这类文件会覆盖全局配置，若有冲突属性需删除或调整。

3. 验证属性加载状态 #

在settings.gradle最顶部添加测试代码，重新同步项目后查看控制台输出，确认属性是否被正确加载：

println("artifactory_user: ${settings.hasProperty('artifactory_user') ? settings.artifactory_user : 'null'}")
println("artifactoryUser: ${settings.hasProperty('artifactoryUser') ? settings.artifactoryUser : 'null'}")

根据输出确认哪个属性名有效，再对应调整配置或代码。

4. 清理Gradle缓存与守护进程 #

• 打开终端执行gradle --stop停止所有Gradle守护进程
• 删除C:\Users\username\.gradle\caches目录下的缓存文件，避免缓存导致配置不生效，之后重新同步项目

5. 插件下载失败补充处理 #

硬编码后仍无法下载插件时，需检查仓库配置：

• 确保settings.gradle中的插件仓库配置正确，示例：

  pluginManagement {
      repositories {
          maven {
              url = uri("${artifactory_contextUrl}/plugins-release")
              credentials {
                  username = artifactory_user
                  password = artifactory_password
              }
          }
          gradlePluginPortal()
      }
  }
  

• 若新电脑需要代理访问Artifactory，在全局gradle.properties添加代理配置：

  systemProp.http.proxyHost=代理地址
  systemProp.http.proxyPort=代理端口
  systemProp.https.proxyHost=代理地址
  systemProp.https.proxyPort=代理端口
  

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