Android Studio单独安装后SDK下载超时/Tag Mismatch问题排查及解决方案

我之前装Android Studio的时候也碰到过一模一样的糟心事——单独下了IDE没带SDK，结果内置下载要么超时要么报tag mismatch，折腾了好几天才搞定，给你梳理下解决方案：

• 网络访问限制：Android SDK默认的下载源是境外服务器，国内访问时很容易因为网络波动、丢包导致下载不完整，这时候校验文件哈希就会出现tag mismatch；超时更不用说，就是连接不上服务器或者速度太慢断了。
• IDE配置问题：比如旧的缓存残留、代理设置错误，或者默认的并发下载线程数太多，被服务器限流了。
• 磁盘权限不足：如果Android Studio没有足够的权限写入SDK文件，下载到一半可能会中断，或者文件损坏，触发校验错误。

先从最容易见效的方法试起：

• 切换国内镜像源：这是解决网络问题的核心步骤
  1. 打开Android Studio，进入Settings（Windows/Linux点File→Settings，Mac点Android Studio→Settings）
  2. 找到Appearance & Behavior → System Settings → Android SDK
  3. 切换到SDK Update Sites标签，取消默认的Google源勾选，添加国内常用的镜像站点（比如阿里云、清华大学的镜像，把对应的HTTP地址填进去）
  4. 点击Apply保存，然后重新触发SDK下载，成功率会高很多
• 清理IDE缓存重启：有时候缓存的损坏文件会干扰校验
  1. 完全关闭Android Studio
  2. 找到IDE的缓存目录：Windows一般是C:\Users\<你的用户名>\.AndroidStudio<版本号>\system\caches，Mac是~/Library/Caches/Google/AndroidStudio<版本号>
  3. 删除caches文件夹里的所有内容，重启IDE后再试下载
• 调整代理或强制HTTP：如果必须用代理，确保在Settings→HTTP Proxy里配置正确并测试连通；也可以修改SDK管理器的启动参数，强制用HTTP而非HTTPS，减少握手失败的概率——找到SDK目录下bin文件夹里的sdkmanager.bat（Windows）或sdkmanager（Mac/Linux），在启动命令里加--no-https参数
• 降低并发线程数：有些服务器会限制并发请求，你可以在调用sdkmanager时加--max-workers=2参数，减少同时下载的线程数，避免被限流
• 检查磁盘权限：Windows右键以管理员身份运行Android Studio，Mac给IDE授权完全磁盘访问权限，确保它能正常写入SDK文件

其实并不是官网没有入口，只是藏得比较深，或者可以通过命令行获取链接：

• 用sdkmanager命令行拿下载链接：
  1. 打开终端，进入Android Studio安装目录下的jre/bin文件夹
  2. 运行命令：java -jar ../lib/sdkmanager.jar --list，这个命令会列出所有可用的SDK组件，以及对应的下载链接
  3. 复制你需要的组件链接，用第三方下载工具（比如迅雷、IDM）下载，然后把文件放到SDK目录的对应文件夹里（比如platforms文件夹放系统镜像，build-tools放构建工具）
• 国内镜像站点直接下载：国内很多镜像站点会同步所有Android SDK组件，你可以直接在这些站点找到对应版本的SDK、Build Tools、System Image等文件，下载后解压到SDK目录的对应位置就行，不需要通过IDE下载

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