新建Kotlin项目运行时触发java.lang.NullPointerException问题

问题本质 #

该空指针异常源于Gradle依赖解析流程的内部错误，从栈信息可见ModuleVersionResolveException的getMessage()方法触发NPE，说明依赖解析阶段某核心对象未完成初始化，大概率是本地缓存损坏、网络异常或Gradle版本bug导致。

修复步骤 #

• 清理Gradle缓存并强制刷新依赖
  执行命令清空缓存并重新拉取依赖：

  ./gradlew clean build --refresh-dependencies
  

  Windows环境使用：

  gradlew clean build --refresh-dependencies
  

• 排查网络与仓库访问
  确认网络可正常访问Maven中央仓库/Google仓库，若使用代理需在gradle.properties中配置正确的代理参数：

  http.proxyHost=你的代理地址
  http.proxyPort=代理端口
  

• 升级Gradle版本
  项目默认Gradle版本可能存在已知bug，可更新至最新稳定版：

  1. 打开gradle/wrapper/gradle-wrapper.properties
  2. 修改distributionUrl为最新版本，例如：

     distributionUrl=https\://services.gradle.org/distributions/gradle-8.7-bin.zip
     

• 重置IDE缓存
  在Android Studio/IntelliJ中操作：

  1. 点击File -> Invalidate Caches...
  2. 勾选Clear file system cache and local history，选择Invalidate and Restart

• 检查仓库配置
  确认~/.gradle/gradle.properties或项目内的gradle.properties无错误仓库地址（如不存在的私有仓库）。

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