前言：好多 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)

Android遇到的问题15对应的图片1.png

这个错误提示意思是：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文件。
  正确解压后的的文件如下图所示：

Android遇到的问题15对应的图片2.png

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

Android遇到的问题15对应的图片3.png

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）重新同步。

图解如下所示：

Android遇到的问题23解决办法.png

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

文件乱码

【解决方案1】：找到对应的module或者lib，打开里面的build.gradle，输入以下代码：

新版gradle用这个：

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

旧版gradle用这个：

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

【解决方案2】：点击Android studio右下角的文件编码按钮，图中红色区域，然后选择UTF-8改选为GBK。

切换编译语言格式

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

【解决方案3】：点击菜单Flie -> Settings -> Editor -> File Encodings，然后文件编码都修改成“UTF-8”,重启Android Studio即可。如下图：

最后：如果设置之后还是不行，建议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”这个问题。

failed to complete gradle execution问题

解决方法有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，可以在module的build.gradle里面添加以下配置：

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
        
        // 或者你可以用下面这种写法：   
        // 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 

30. Could not find com.android.tools.lint:lint-gradle:XXXX 问题的解决

【原因分析】打包出现的错误。

【解决方法】

在app目录里面的build.gradle 加上以下代码，然后重新运行项目就OK了：

 lintOptions {
        checkReleaseBuilds false
        abortOnError false
    }

31. emulator: ERROR: x86 emulation currently requires hardware acceleration

【原因】HAXM没有安装，或者BOIS界面没有启用Virtualization Technology。

1.安装HAXM

2.sdk\extras\intel\Hardware_Accelerated_Execution_Manager文件夹双击安装一下intelhaxm-android.exe。
如果安装成功，去AS重新模拟器就可以了。

3.BOIS界面启用Virtualization Technology，具体根据电脑型号，自行百度一下，不同电脑设置不一样。

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

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