前言：好多 Android 开发者都在说Android Studio太坑了，老是出错，导致开发进度变慢，出错了又不知道怎么办，网上去查各种解决方案五花八门，有些可以解决问题，有些就是转来转去的写的很粗糙，让人看了云里雾里。我就很不爽这种做法，要么就不写，要写就写出让人一目了然的东西，所以在这里我就详细了总结了一下Android Studio2.X的那些坑。

【tips】如果这里没有你遇到的难题，欢迎留言提出来，我能解决的就一定帮你搞定。

下一篇讲解Android Studio3.0填坑指南

---

本文同步在github发布，有兴趣的可以去看看。https://github.com/AweiLoveAndroid/The-pit-of-the-Android-Studio

---

这篇博客大体上分为以下几个方面的内容：

1）关于sdk  点击此处链接: 1

2）关于jdk  点击此处链接: 7、8、26、27、28

3）关于加速器（Intel HAXM）和启动问题   点击此处链接： 2、 3、 4、 5、 29

4）关于gradle  点击此处链接：9、 15、 19、 23、25

5）关于混淆打包编译  点击此处链接：10、 22

6）关于依赖库和插件  点击此处链接：6、 11、 12、 13、 18

7）关于配置和源码关联  点击此处链接：14、 16、 20、 21、 24

8）关于模拟器  点击此处链接：17

---

1. Android Studio第一次启动时出现 unable to access android sdk add-on list

出现原因:电脑没有sdk,studio也没有自带sdk;

解决办法:在安装studio的目录下找到bin\idea.properties,打开这个文件,在末尾加上一行
  disable.android.first.run=true就行了,如果打不开这个文件就用editplus或者sublime text打开

2. 在安装了新的 Android Studio 之后，AVD 新建并启动模拟器的时候报以下错误：

emulator:ERROR:x86 emulation currently requires hardware acceleration!
Please ensure Intel HAXM is properly installed and usable.
CPU acceleration status: HAX kernel module is not installed!

出现原因:原来新的 Android SDK 在运行虚拟机的时候，需要安装 Intel HAXM：一个硬件加速器，为的是在x86平台上加快安卓虚拟机的运行。

解决方法:
(1) 在安装之前首先到 SDK 的安装目录下打开SDK Manager：
  找到 Inter....(中间的很多单词就不写了,重点看到 Inter 和 HAXM 就可以了点击下载) HAXM 点击install
(2) 然后进入到你SDK的目录下，再进入extras —> intel —> Hardware_Accelerated_Execution_Manager，
  可以看到HAXM的安装文件：interhaxm-android.exe
(3) 但是在安装之前还有一个步骤，就是重启计算机，进入开机界面前按F2进入到计算机的BIOS下，
  切换到 Configuration 找到下面的 Intel Virtual Technology。设置为Enable状态（即允许虚拟机技术），
  然后再双击interhaxm-android.exe安装,一直next就可以了

3. Intel 加速器 HAXM ，安装过程中可以会出现如下错误:

"Failed to configure driver: unknown error. Failed to open driver"

有以下几个步骤可以解决该问题：
(1) 下载haxm_extra_workaround.zip 附件
(2) 解压后提取hax_extract.cmd 文件到 HAXM 的解压文件路径中
(3) hax_extract.cmd 右键用管理员权限运行。
执行以上步骤后，基本可以解决以上提示的安装异常问题。

4. 因为电脑卡死,结束了qemu-system-i386.exe这个倒霉的进程,导致我开启模拟器的时候一直提示我没有安装Intel HAXM,只好再安装一遍，然后出现了以下问题:

This computer meets the requirements for HAXM,but IntelVirtualization Technology(VT-x) is not turned on.
HAXM can be installed,but will not work until VT-x is enabled.
Please refer to the Inter HAXM documentation for more infomation.

解决办法:

如果在安装过程中出现Intel virtualization technology (vt,vt-x) is not enabled的错误，需要进
入的电脑的BIOS中修改，重启电脑，进入BIOS页面（一般在开机时按Del或F2，根据电脑不同，进入方式不
同）,找到Advanced Mode –> Advanced –> CPU Configuration –> Intel Virtual Technology设置为
Enabled（表示开启虚拟化）就可以了。重启Android studio就可以了。

5. 关于intelhaxm-android.exe安装的坑:不管是双击还是右键以管理员身份运行都没用，怎么解决？

解决办法:

在SDK\extras\intel\Hardware_Accelerated_Execution_Manager中
找到intelhaxm-android.exe，右键解压,双击setup.exe安装就好了

6. Failed to resolve: junit:junit:4.12

出现原因：项目中引用了junit库中的代码，但是却没有相关的junit的依赖库

解决办法：添加相关的依赖库引用,在项目的Module的build.gradle中添加如下代码就OK了

repositories {
    maven { url 'http://repo1.maven.org/maven2' }
    }

7. 只要是API24以上的Android Studio，如果JDK低于1.8都会出现这个问题，比如我列举两个:

（1）Error:Execution failed for task':app:compileOrangeDevDebugJavaWithJavac'.compileSdkVersion 'android-24' requires JDK 1.8 or later to compile.

（2）Android N requires the IDE to be running with Java 1.8 or later

解决办法:把1.8以前的jdk都卸载掉,然后把环境变量配置成1.8的,就可以了.

8. Error:(1, 1) A problem occurred evaluating project ':app'.com/android/jack/api/ConfigNotSupportedException :Unsupported major.minor version 52.0

解决办法:

（1）把1.8以前的jdk都卸载掉，使用1.8版本的jdk
（2）File - Project Structure - SDK Location - JDK location，这里面有个选项，
    可以选择"use embedded JDK(recommended)"，使用AS内置的JDK。（不推荐这样做）

9. Unknown host 'downloads.gradle.org' 这个问题的解决:

使用android studio的gradle新建项目时候出现:
Error:Unknown host 'downloads.gradle.org'.Enable Gradle 'offline mode' and sync project.
Learn about configuring HTTP proxies in Gradle
或者出现 Error:No cached version listing for com.android.tools.build:gradle:0.12.+ av

解决方法如下：

不是第一次的话以后就可以点这里的clean了。

或者更直接点，打开cmd，找到你的项目根目录，输入gradle clean（前提是下载gradle，并且设置环境变量）

如果还是下载不了的话，请看下文介绍：

具体的android studio 配置
安装步骤：
1.先下载as，下载地址：https://developer.android.google.cn/studio/index.html 下载完直接安装，安装完打开它，然后会出现下载gradle-XXX-bin.zip，根据Android Studio版本下载对应的Gradle版本，下载这个一般都会卡死，不过不要紧，把as关掉。
2.下载gradle-XXX-bin.zip，下载地址：http://services.gradle.org/distributions/，下载完之后，找到目录： C:\Users\用户名.gradle\wrapper\dists\gradle-XXX-bin\vruqmccc8532n7gr46qavsii8\ 把下载的gradle-XXX-bin.zip放到该目录下，并且把gradle-XXX-bin.zip解压到该目录(解压得到的文件为gradle-XXX)。
3.最关键的来了，把该目录下的gradle-XXX-bin.zip.part文件删除，然后复制gradle-XXX-bin.zip.lck，把它改为gradle-XXX-bin.zip
4.到此你就可以运行Android Studio开发了。

另附： Android Studio和gradle版本对照图请参考我的github Android Studio版本、Gradle版本、Build Tools版本三者之间对照详细解答

10. 关于混淆出现的问题：

(详细请看 http://www.open-open.com/lib/view/open1490252413493.html)

问题一：出现 Unknown verification type [95] in stack map frame 错误
Error:Execution failed for task
‘:app:transformClassesWithMultidexlistForNiannianDebug’.Java .io.IOException:
Can’t read [
E:SVNbroondontrunkcodebroodon_androidappbuildintermediatestransformsjarMergingnianniandebugjars11fcombined.jar]
(Can’t process class [com/tencent/wxop/stat/al.class] (Unknown verification type [95] in stack map frame))

原因分析：引用的第三方库已经混淆过，再在本地进行编译混淆的时候就会报出这个错误。

解决办法: 则修改混淆器，重新进行编译，将新的混淆器覆盖原来的混淆器，则可以解决。

问题二：
Error:Execution failed for task ‘:app:transformClassesWithMultidexlistForNiannianDebug’.
proguard.KeepClassSpecification.(ZZZZZZLproguard/ClassSpecification;)V

原因分析：升级 Android studio 以后，使用的混淆器版本不一致

解决办法: 根据 Android studio版本选择与之对应的混淆器版本

11. 这是什么原因？是因为65535问题？还是因为v7包重复了？ 【待解决。。。】

Error:Execution failed for task ':app:transformClassesWithDexForDebug'.

com.android.build.api.transform.TransformException: java.lang.RuntimeException:
java.lang.RuntimeException: com.android.ide.common.process.ProcessException:java.util.concurrent.ExecutionException:
com.android.ide.common.process.ProcessException: Return code 1 for dex process

12. non-zero exit value 1； 和 non-zero exit value 2； 和 non-zero exit value 3 问题的解决：

Error:Execution failed for task ':app:transformClassesWithDexForDebug'
com.Android.build.api.transform.TransformException: 
com.android.ide.common.process.ProcessException: 
org.gradle.process.internal.ExecException:Process 'command 'F:\Program Files (x86)
 \Java\jdk1.8.0_31\bin\java.exe'' finished with non-zero exit value 1

问题一： non-zero exit value 1原因分析：

原因分析：这个是因为依赖包重复了 （像v4和nineoldandroids），app中实现了对easeUI的依赖，但是app和easeUI都添加了对v4这个包的依赖。

解决办法:
    把v4包注释修改之后，clean，rebuild一下，OK

问题二： non-zero exit value 2

解决办法:
    这个错误在app的build.gradle里面添加下面这句就好了。
    android {
       
        defaultConfig {
            ...
            multiDexEnabled true
        }

    }

问题三： non-zero exit value 3

解决办法:
   这个错误就在app的bulid.gradle里面加上这句，再rebuild ,之后再运行就行了。4g可以看电脑配置修改（2g,3g,6g,8g）。
    dexOptions {
        javaMaxHeapSize "4g"
    }

13. 打开Android Studio报错

Plugin Error: required plugin “Android Support” is disabled

更详细的错误信息如下：
Problems found loading plugins:
Plugin "Google Analytics Uploader" was not loaded: required plugin "Android Support" is disabled.
Plugin "SDK Updater" was not loaded: required plugin "Android Support" is disabled.
Plugin "Android NDK Support" was not loaded: required plugin "Android Support" is disabled.
Plugin "Google App Indexing" was not loaded: required plugin "Android Support" is disabled.
Plugin "Google Cloud Tools For Android Studio" was not loaded: required plugin "Android Support" is disabled.
Plugin "Google Cloud Testing" was not loaded: required plugin "Android Support" is disabled.
Plugin "Google Services" was not loaded: required plugin "Android Support" is disabled.

解决办法:

  打开File-Settings-Plugins，把报红色的插件全部取消勾选，在把Android Support勾选，然后Apply-Save，重启下studio 就可以了。

14. 自定义android studio的配置文件目录后，无法正常安装和卸载插件(貌似2.0版本之后的插件安装卸载就有问题了)是何原因？详情看知乎 https://www.zhihu.com/question/38604486

解决方法:

方法(1)：将idea.system.path/plugins下的文件移动到{idea.config.path}/plugins下（如果是压缩包，则需要先解压）。 
  然后重启一下AS就可以了。删除也是，貌似也得手动去文件夹下删除）

方法(2):修改AS安装目录下的idea.properties文件：
  idea.config.path=D:/.AndroidStudio2.0/config 
  idea.system.path=D:/.AndroidStudio2.0/system 
  idea.plugins.path=${idea.system.path}/plugins

15. 导入android studio项目，出现的问题：

Error:Failed to open zip file.
Gradle's dependency cache may be corrupt (this sometimes occurs after a network connection timeout.)
Re-download dependencies and sync project (requires network)
Re-download dependencies and sync project (requires network)

这个错误提示意思是：Gradle's dependency cache may be corrupt：（Gradle的依赖缓存可能是损坏的。）

• 原因分析：我们要导入别人写好的工程时，一般不需要更改什么，as智能判断会提示我们是否需要对build gradle setting之类的文件进行修改。针对gradle个版本工具来说，如果不选择更新直接原来的Gradle Version中的Gradle工具，再加上.gradle库中没用该版本时，as会创建这样的库，有时候这样的库会下载不完整，导致上面的问题。

• 解决办法:

    1.下载 gradle
  

  下载地址很简单，以 下载gradle-3.5-all.zip为例子。不要去网上找这样那样的网站下载gradle工具了。浏览器输入以下链接快速下载：
  services.gradle.org/distributions/gradle-3.5-all.zip

    2.复制替换
  

  下载完成后替换 C:\Users\Administrator.gradle\wrapper\dists\gradle-3.3-all
  exhrs6ca08n232b14ue48lbye中对应的gradle-3.5-all.zip文件。
  正确解压后的的文件如下图所示：

    3.重新打开项目，对工程中做一些配置如下，重新编译一下，就没问题了:

16. Android studio 源码无法关联，提示Souces for android api 25 platform not found:

解决方法：

1）找到jdk.table.xml这个文件

jdk.table.xml文件路径：(以win7为例，Administrator是电脑的用户名，我当前开发工具版本号是Android Studio2.3)
C:\Users\Administrator\.AndroidStudio2.3\config\options\jdk.table.xml

2）在<sourcePath>节点下添加这一句<root type="simple" url="file://E:/android/sdk/sources/android-25" />

修改后的部分配置文件如下：注意红色方框部分，找到对应的编译版本，再添加对应的源码位置

17. com.android.ddmlib.SyncException: No space left on device

解决方法：

把模拟器里没用的应用或者demo卸载卸载。如果还不行，就重启或者重新创建一个模拟器

18. app:transformClassesWithJarMergingForDebug

原因：重复依赖导致的.

解决办法：

找到报错的那个提示，看上面报错的是哪个类，双击shift搜索一下，看这个报错的类在哪个依赖库里面用到了。
在AS中，选择以project显示项目，找到最下面的External Libraries，然后继续找，找到相对应的类库。
点开之后发现了一个pom.xml，这里面就是关于这个jar的一些配置文件，往下找，发现了一个依赖库的引用，
复制里面groupId，到你的app的build.gradle里，找到那个依赖，添加{exclude group: 'XXX'} XXX换成刚才复制的groupId，这样就
把这个groudId的引用去除掉。

19. processdebugresources

原因：build.gradle的兼容包和compileSdkVersion配置不对引起的

解决办法：让兼容包和compileSdkVersion匹配就OK了。关于这个版本匹配，请查看上面的第9点那张表格。

20. Android Studio配置androidannotations出现 Error:Execution failed for task ':app:compileDebugJavaWithJavac'

原因： androidannotations配置环境对SDKtools, Build Tools, Platform Tools 以及 SDK Platform有要求，不匹配的话就会报错

解决办法：打开SDK Manager，更新SDKtools, Build Tools, Platform Tools 以及 SDK Platform到最新版本

21. Error:com.android.builder.internal.aapt.AaptException: Failed to crunch

原因： 项目路径太长，导致有的资源文件整个路径长度超过了240个字符。这是Android Studio的一个坑。

解决办法：

（1）重命名项目名，重新运行一下。
（2）如果以上方法不行，就缩短路径深度，减少路径层级，每一级路径名字尽可能的缩短。

22. Android Studio编辑时发生的错误

Error:warning: Ignoring InnerClasses attribute for an anonymous inner class

原因：有3种情况可以导致这种错误发生：

• (1)导了重复jar包，或者导入了不同版本的同名jar包。

• (2)AndroidStudio打签名包时android.keystore 的密码输入错了

• (3)有可能是Dex的方法数超过上限导致的。

解决办法：

• (1)把重复的jar包删除掉，Rebuild Project，就OK了，如果，还有其他问题，那证明你的app下的build.gradle依赖配置就有问题。

• (2)重新打包一个正式包，重新输入签名账号密码。

• (3)在项目的build.gradle文件中添加multiDexEnabled true 搞定。

示例：

之前是在win7电脑的工程运行在mac电脑，打开就出了这样的错误。解决这个问题的方式，给大家分析一下：

1.第一考虑是不是可以直接忽略第三方的属性的错误警告.找到项目下对应的proguard-rules.pro文件,在proguard-rules.pro文件中
  添加如下代码

-keepattributes EnclosingMethod

2.查看第三方jar有没有重复利用的，发现并没有。继续下一步。

3.看看是不是Dex越界引起的问题。在项目的build.gradle文件中添加以下代码:

multiDexEnabled true

重新编译之后，项目成功移植了。

23. Android Studio版本更新后Gradle版本不匹配问题

Error:(1, 0) The android gradle plugin version 2.3.0-beta1 is too old, please update to the latest version.
To override this check from the command line please set the ANDROID_DAILY_OVERRIDE environment variable to "xxxxxxx"

问题截图如下：

解决办法：升级Gradle到合适版本，具体操作如下：

【特别说明】Android Studio版本和gradle版本是相匹配的，不是随意匹配的，版本不匹配就会出错。具体的Android Studio和gradle版本对照请看 Android Studio和gradle版本对照

• （1）访问 Gradle官网下载地址 来下载与之匹配的Gradle版本或者最新的Gradle工具包；

• （2）解压到Android Studio的gradle目录下；

• （3）File->Setting->Build,Exection,Deployment->Gradle->Use local gradle distribution，修改Gradle home为AS安装
  目录下最新的gradle版本；

• （4）修改对应Project的build.gradle中的com.android.tools.build:gradle:版本号为提示版本(如修改classpath 'com.android.tools.build:gradle:2.3.0-beta1'为classpath 'com.android.tools.build:gradle:2.3.0-beta3')；

• （5）修改gradle-wrapper.properties中distributionUrl上的版本号与当前Gradle版本号一致(如修改distributionUrl=https\://services.gradle.org/distributions/gradle-3.2-all.zip为distributionUrl=https\://services.gradle.org/distributions/gradle-3.5-all.zip)；

• （6）重新同步。

图解如下所示：

24.AppConfig.java文件中文乱码，log也乱码问题的解决。

解决办法：找到对应的module或者lib，打开里面的build.gradle，输入以下代码：

新版gradle用这个：

tasks.withType(JavaCompile) {
    options.encoding = "UTF-8"
}

旧版gradle用这个：

tasks.withType(JavaCompile) {
    options.encoding = "UTF-8"
}

【另外】：上述方法如果不管用，试着点击Android studio右下角的文件编码按钮，图中红色区域，然后选择UTF-8改选为GBK。

此时会弹出窗口提示是否重载文件，选择“Reload”，基本也可以搞定。

如果设置之后还是不行，建议clean一下，重启一下Android Studio。

---

25. failed to complete gradle execution问题

使用Android Studio创建新项目后，一直出现 “Failed to complete Gradle execution. Cause: A fatal exception has occurred. Program will exit”这个问题。

解决方法有2个（2种方式实质上还是一样的）

• 方法1：打开工程的gradle.properties文件，添加如下配置项，这个问题应该就不会出现了。

    org.gradle.jvmargs=-Xmx512m -XX:MaxPermSize=512m
  

如下图所示：

• 方法2：在Android Studio中，选择File -> Settings -> Compiler -> 在VM options选项中填写：

    -Xmx512m -XX:MaxPermSize=512m
  

如下图所示：

26. 控制台乱码的解决方式：

旧版本的gradle

tasks.withType(Compile) {
    options.encoding = "UTF-8"
}

新版本的gradle

tasks.withType(JavaCompile) {
    options.encoding = "UTF-8"
}

27. AS 2.X如何支持java8？

AS 2.X最高是支持java7的环境，要想支持java8，可以做以下设置：

如果是安卓的module，可以做以下配置：

android {
    compileSdkVersion 25
    buildToolsVersion "25.0.3"
    defaultConfig {
        applicationId "com.lzw.java8demo"
        minSdkVersion 25
        targetSdkVersion 25
        versionCode 1
        versionName "1.0"
        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"

        // 这个别忘记加上去
        jackOptions {
            enabled true
        }

    }

    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }

    // 指定java8编译
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }

}

如果是创建的java的module，在gradle最后加上以下配置：

 sourceCompatibility = "1.8"
 targetCompatibility = "1.8"

28. Error:Execution failed for task':apptransformClassesWithDesugarForDebug'

我看报错那里说的是注解报的错，我怀疑是jdk不一致导致的。我是打开IDE报的错，我把as的配置导入到了IDE，打开项目就报错了，as用的是jdk1.8，不知道这个IDE是不是要用jdk1.7？
目前还没找到原因。。

29.AS打开速度慢如何解决？

在Android Studio的bin目录里，打开idea.prooperties文件，添加

disable.android.first.run=true 

---

这里没提到的可以参考： https://my.oschina.net/Jieth/blog/489014，以后会逐渐补充进去。

---

最后，推荐一本书给大家看看，希望对大家有帮助。