Android Studio重建找不到Gradle构建任务,同步提示null对象sync属性错误原因
问题根因
- Gradle在评估根项目配置阶段抛出空指针异常,调用未初始化对象的
sync属性失败,导致项目配置加载中断,无法生成构建任务列表,进而触发Rebuild时找不到任务、Gradle同步失败的连锁报错。常见触发场景如下:- 根项目
build.gradle或settings.gradle存在语法错误,自定义配置、第三方插件配置中调用了未提前初始化的对象的sync属性 - 项目使用的Gradle版本与Android Gradle Plugin(AGP)版本不兼容,版本规则冲突导致配置加载时核心对象初始化失败
- 本地Gradle缓存、Android Studio项目缓存损坏,异常缓存导致配置执行逻辑错误
settings.gradle配置错误,未正确引入子模块或模块路径填写错误,导致项目结构解析失败
- 根项目
修复步骤
- 检查配置文件语法错误:打开根目录
build.gradle和settings.gradle,全局搜索sync关键字,确认该属性所属的对象是否有提前初始化逻辑,无空安全校验,修复拼写错误、变量未赋值问题后重新同步 - 校验Gradle与AGP版本匹配:查看
gradle/wrapper/gradle-wrapper.properties中的distributionUrl字段确认Gradle版本,查看根目录build.gradle中dependencies块下的com.android.tools.build:gradle版本,确认二者符合官方版本匹配规则,不匹配则统一调整版本后重试 - 清理损坏缓存:
- 点击Android Studio菜单栏
File -> Invalidate Caches...,勾选清理文件系统缓存和本地历史,确认重启IDE - 手动删除项目根目录下的
.gradle、.idea文件夹,以及所有子模块下的build文件夹,重新打开项目触发Gradle同步
- 点击Android Studio菜单栏
- 关闭Gradle离线模式:进入
Settings -> Build, Execution, Deployment -> Build Tools -> Gradle,取消勾选Offline work后重新执行同步操作
内容的提问来源于stack exchange,提问作者Malo
相关产品推荐
相关产品推荐

