Android Studio新建项目首次构建失败,求助排查解决方法
解决Android Studio首次构建项目的Java编译与Run Tasks错误
Hey,我来帮你搞定这个头疼的构建问题!从你的描述来看,新建项目就踩了编译和Run任务的坑,换JDK、重装AS都没解决,还找不到日志——咱们一步步来排查:
1. 先找到关键的构建日志
你说找不到日志?其实AS的构建日志就在眼前:
- 打开AS底部的
Build面板(没显示的话,点顶部菜单栏的View > Tool Windows > Build) - 点击面板左侧那个「列表样式」的
Toggle View按钮,就能看到完整的错误详情,比截图里的提示有用多了 - 另外,项目根目录的
app/build/outputs/logs文件夹里,还有专门的编译日志文件,比如compileDebugJavaWithJavac.log,也能帮你定位问题
2. 换掉老旧的JDK 10,用兼容版本
JDK 10其实已经被Android Gradle Plugin(AGP)淘汰了,现在AS官方推荐用JDK 11或17(都是LTS长期支持版本,稳定性拉满)。你之前用JDK10大概率是核心问题:
- 先卸载JDK10,去OpenJDK官网(或者Oracle)下载JDK11
- 重新配置
%JAVA_HOME%指向JDK11的安装目录,记得把%JAVA_HOME%\bin加到系统PATH里 - 打开AS,进File > Project Structure > SDK Location,要么选刚装的JDK11,要么直接勾选
Embedded JDK——之前内嵌JDK出错可能是旧缓存搞的,重装AS后应该没问题了
3. 修正Gradle与AGP的版本匹配
新建项目的默认Gradle配置可能版本不兼容,改一下试试:
- 打开项目根目录的
build.gradle(注意是Project级别的,不是Module的),把AGP版本改成适配JDK11的:dependencies { classpath "com.android.tools.build:gradle:7.4.2" // 这个版本完美适配JDK11 // 其他依赖不用动 } - 再打开
gradle/wrapper/gradle-wrapper.properties,把Gradle版本改成和AGP对应的:
(AGP和Gradle的版本对应关系,Android官方文档里有,这个组合是经过验证的稳定搭配)distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-bin.zip
4. 清掉缓存,从头构建
有时候缓存损坏会搞出各种奇怪的错误,清一波试试:
- 点AS顶部的File > Invalidate Caches...,勾选
Invalidate and Restart,等AS重启自动构建 - 也可以手动删项目根目录的
.gradle和app/build文件夹,然后点Build > Clean Project,再Rebuild Project
5. 确认系统环境变量没毛病
最后检查下环境变量:
- 打开命令提示符,输入
java -version和javac -version,确保显示的是JDK11的版本 - 输入
echo %JAVA_HOME%,确认路径是对的,没有多余空格或者拼写错误
如果做完这些还是不行,把Build面板里的完整错误日志贴出来,我帮你精准定位问题!
内容的提问来源于stack exchange,提问作者Franken
相关产品推荐
相关产品推荐

