問題現象
SDK Manager 打開顯示錯誤圖標，包列表為空/灰色，提示「Failed to fetch URL」或長時間「Fetching...」。
根因
**默認下載源 `dl.google.com` 國內無法直連**。SDK Manager 為 Java 程序，受系統代理影響有限，需在工具內配置 HTTP Proxy。
解決方案（按成功率排序）
方案一：SDK Manager 內配置國內鏡像 HTTP Proxy (最直接、無需翻牆)
- 打開 SDK Manager (獨立運行 `android.bat` / `tools/android` 或 Android Studio → Tools → SDK Manager)。
- 菜單 **Tools → Options** (獨立版) / **Appearance & Behavior → System Settings → HTTP Proxy** (AS 內建)。
- 設置：
- HTTP Proxy Server：`mirrors.neusoft.edu.cn` / `mirrors.ustc.edu.cn` / `mirrors.tuna.tsinghua.edu.cn`
- HTTP Proxy Port：`80`
- ✅ **Force https:// sources to be fetched using https://** (關鍵：強制走 HTTP 避免 HTTPS 證書/握手問題)
- 點 **Apply / OK**，然後 **Packages → Reload**。
方案二：修改 `androidtool.cfg` / `android.ini` 配置文件 (適合無界面/腳本)
# ~/.android/androidtool.cfg (Linux/Mac)
# %USERPROFILE%\.android\androidtool.cfg (Windows)
http.proxyHost=mirrors.neusoft.edu.cn
http.proxyPort=80
sdkman.force.http=true
方案三：手動下載離線包安裝 (離環境/極慢網絡)
- 瀏覽器訪問鏡像站：`https://mirrors.tuna.tsinghua.edu.cn/android/repository/`
- 下載 `repository2-1.xml` 解析所需包 URL，或直接進 `repository-11.xml` 找 `` `` 等標簽下的 `` URL。
- 常用包直接下載 `.zip`：
- Platforms: `android-33_r01.zip` 等
- Build Tools: `build-tools_r34.zip`
- Platform Tools: `platform-tools_r34.zip`
- System Images: `sys-img/android-33/default/...`
- 解壓到 SDK 目錄對應子目錄：
$ANDROID_SDK/
├── platforms/android-33/
├── build-tools/34.0.0/
├── platform-tools/
├── system-images/android-33/default/x86_64/
- 重啟 AS/SDK Manager 自動識別。
方案四：系統級代理/VPN (需合法合規)
- Clash/V2Ray **TUN 模式** / **系統代理** 全局攔截 Java 進程。
- 或啟動 SDK Manager 時注入代理：`_JAVA_OPTIONS="-Dhttp.proxyHost=127.0.0.1 -Dhttp.proxyPort=7890 -Dhttps.proxyHost=127.0.0.1 -Dhttps.proxyPort=7890" android.bat`
方案五：遷移至 Android Studio 內建 SDK Manager (現代標準)
- AS 內建 SDK Manager (Tools → SDK Manager) 支持**斷點續傳、並發下載、鏡像配置持久化**。
- 配置：`Settings → Appearance & Behavior → System Settings → HTTP Proxy` 同方案一。
- Gradle 鏡像同步配置 `build.gradle` `repositories { maven { url 'https://maven.aliyun.com/repository/google/' } }`。
常見鏡像源地址 (2024 可用)
| 名稱 | HTTP Proxy Host | 特點 |
|---|
| 清華大學 | mirrors.tuna.tsinghua.edu.cn | HTTPS 支持好、同步快 |
| 中科大 | mirrors.ustc.edu.cn | 老牌、穩定 |
| 東軟 | mirrors.neusoft.edu.cn | HTTP 兼容好、SDK Manager 專用推薦 |
| 阿里雲 | maven.aliyun.com | Gradle/Maven 鏡像、非 SDK Manager 直接源 |
總結
**SDK Manager 連接失敗 99% 是網絡不通**。**「Tools → Options → HTTP Proxy 設置國內鏡像 (東軟/清華/中科大) + 強制 HTTP」是零成本、即時生效的標準解法**；離線環境用「手動下載離線包」；長遠看**「遷移至 Android Studio + Gradle 阿里雲鏡像」是標準化出路**。
