Android Studio下载SDK时出现tag mismatch错误:含义及解决方法
嘿,这个问题我之前帮不少开发者踩过坑,我来给你掰扯清楚:
什么是"tag mismatch"?
简单来说,就是你下载的SDK安装包,它的校验标签和官方提供的对不上。官方为了防止文件被篡改或者下载不完整,会给每个SDK包生成一个唯一的校验值(比如哈希值,也就是所谓的"tag")。当你下载的包在本地计算出来的校验值和官方存的不一样时,SDK管理器就会抛出这个错误——说白了就是:你拿到的文件不是官方想要给你的那个,要么坏了,要么不对。
常见的原因有:网络波动导致下载中途丢了数据、本地缓存的旧文件搞混了、第三方镜像源同步不及时,甚至是代理工具干扰了下载过程。
怎么修复这个问题?
给你几个按优先级尝试的方案:
先清SDK管理器的缓存
打开Android Studio的SDK Manager,点右上角那个齿轮图标,选「SDK Update Sites」,切到「Cache」标签页,点击「Clear Cache」。清完缓存重启一下SDK Manager,再试试下载,大部分时候这个操作就能解决问题。手动删掉损坏/不完整的文件
找到你的SDK安装目录:- Mac用户一般是
~/Library/Android/sdk - Windows用户默认是
C:\Users\<你的用户名>\AppData\Local\Android\Sdk
进去后先把temp文件夹里的所有文件删掉(这些是下载的临时文件),再检查platforms、build-tools这些目录里有没有下载到一半的文件夹(比如名字带乱码或者没下载完的),也一并删掉,然后重新发起下载。
- Mac用户一般是
切换到靠谱的SDK源
如果你之前用了第三方镜像源,可能是镜像同步不及时导致tag不匹配。回到「SDK Update Sites」页面,把第三方镜像的勾选去掉,只保留Google的官方源。要是国内访问官方源太慢,就换个国内同步及时的镜像(比如阿里云的),但一定要选口碑好的,避免源本身有问题。排查网络和代理问题
不稳定的Wi-Fi或者代理工具中途断连,很容易导致下载的文件残缺。试试切换到有线网络,或者暂时关掉代理、VPN,再重新下载。极端情况:重装Android Studio
如果上面的方法都不管用,可能是Android Studio的配置文件或者SDK的核心文件出了问题。先把Android Studio彻底卸载(记得删掉SDK目录和本地的配置文件),然后去官网下载最新版本重新安装,再从头配置SDK。
内容的提问来源于stack exchange,提问作者birukhimself




