Gradle无法读取用户主目录gradle.properties文件的问题排查求助

看起来你遇到了Gradle无法加载全局gradle.properties的典型问题，我帮你梳理几个关键的排查步骤，大概率能定位到原因：

1. 先确认全局配置文件的正确存放路径 #

这是最常见的错误：Gradle默认读取的全局gradle.properties是在用户主目录下的.gradle子文件夹里，而不是直接放在用户根目录！

比如Windows系统下，正确路径应该是：

C:\Users\你的实际用户名\.gradle\gradle.properties

你之前把文件放在C:/Users/USERNAME根目录是不对的，先把文件移到.gradle文件夹里（如果.gradle文件夹不存在，手动创建一个），再测试一次。

2. 验证Gradle是否加载了目标属性 #

执行以下命令查看项目所有可用属性：

gradle properties

在输出结果里搜索ossrhUsername，如果能找到对应的属性值，说明加载成功；如果找不到，继续往下排查。

3. 检查属性文件的格式正确性 #

确保你的gradle.properties文件格式符合要求：

• 每行都是key=value的格式，不要有多余空格（比如ossrhUsername= your-jira-id里的空格会被当作值的一部分）
• 属性名大小写敏感，确认ossrhUsername、ossrhPassword拼写完全正确
• 不要给值加引号（除非值包含特殊字符，这里不需要）
• 注释要以#开头，避免注释内容干扰属性读取

4. 排查是否有其他配置覆盖了全局属性 #

Gradle属性加载有优先级，以下来源的属性会覆盖全局配置：

• 命令行通过-P传递的属性（比如gradle build -PossrhUsername=xxx）
• 项目根目录下的gradle.properties文件
• 前缀为ORG_GRADLE_PROJECT_的环境变量（比如ORG_GRADLE_PROJECT_ossrhUsername）

检查这些地方是否存在同名属性，导致全局配置被覆盖。

5. 查看Gradle调试日志，追踪文件加载过程 #

执行带调试日志的构建命令：

gradle build --debug

在日志中搜索gradle.properties，你会看到Gradle尝试读取的所有配置文件路径，以及每个文件加载的内容。如果日志中没有出现你放的全局配置文件路径，说明Gradle没找到它；如果有加载记录但报错，可能是权限问题或文件损坏。

6. 手动指定全局配置路径测试 #

如果以上步骤都没解决，可以手动指定Gradle的全局配置目录来测试：

gradle build -g C:\Users\你的实际用户名\.gradle

或者直接用命令行参数临时传递属性，验证代码逻辑是否正常：

gradle build -PossrhUsername=your-jira-id -PossrhPassword=your-jira-password

如果这样能正常输出属性值，说明之前的全局配置文件路径或加载逻辑有问题。

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