Android SDK安装失败：SocketTimeoutException超时问题解决咨询

问题原因 #

• 网络访问受限：Android SDK的系统镜像文件存储在境外服务器，国内网络访问时速度慢，大体积的Intel x86 Atom_64镜像容易触发读取超时。
• 默认源下载效率低：Android Studio默认的Google Maven源在国内访问不稳定，下载过程中超出系统默认超时阈值，抛出SocketTimeoutException。
• 代理/防火墙干扰：本地防火墙、杀毒软件或代理设置可能中断了下载连接，导致读取超时失败。

解决方案 #

1. 切换国内SDK镜像源 #

• 打开Android Studio，进入设置（Windows/Linux：File > Settings；Mac：Android Studio > Settings）。
• 找到Appearance & Behavior > System Settings > Android SDK，切换到SDK Update Sites标签页。
• 点击+添加国内镜像源，比如阿里云或清华大学的镜像：
  • 阿里云：https://mirrors.aliyun.com/android/repository/
  • 清华大学：https://mirrors.tuna.tsinghua.edu.cn/android/repository/
• 取消勾选默认的Google源，点击Apply保存后重新尝试安装组件。

2. 手动下载安装镜像文件 #

• 找到对应API Level 31、revision 4的Intel x86 Atom_64 System Image下载地址（可通过搜索组件包名system-images;android-31;google_apis;x86_64获取）。
• 下载完成后，定位到本地Android SDK安装目录，进入system-images/android-31/google_apis/路径，没有对应文件夹就手动创建。
• 将下载的压缩包解压到该目录，确保目录结构和其他已安装的系统镜像一致。
• 回到Android Studio的SDK Manager，刷新后就能识别到已安装的镜像。

3. 延长下载超时时间 #

• 找到Android Studio安装目录下的bin文件夹（Mac为Contents/bin），打开idea.properties文件。
• 在文件末尾添加：idea.connection.timeout=300000（设置为5分钟超时，单位毫秒）。
• 重启Android Studio后重新尝试安装。

4. 排查代理与防火墙 #

• 临时关闭本地防火墙或杀毒软件，避免其拦截SDK下载请求。
• 进入Android Studio设置的HTTP Proxy页面，检查代理配置是否正确，必要时切换为No proxy再尝试下载。

5. 跳过模拟器镜像（真机打包专用） #

• 注意：Intel x86 Atom_64 System Image是给Android模拟器用的，真机打包完全不需要这个组件。
• 在SDK Manager中取消勾选该镜像，只安装Android SDK Platform 31和对应版本的Android SDK Build-Tools，就能满足三星Galaxy S10（Android 12）的打包需求，同时适配Ionic v6.20.4的依赖。

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