問題現象
SDK Manager 打開顯示「Fetching URL...」長時間無響應,或報錯「Failed to fetch URL... Connection timed out」,可用包列表為空/灰色不可選。
根因
**Android SDK Manager 默認訪問 `dl.google.com` / `dl-ssl.google.com` 下載包索引與文件,國內網絡環境無法直連或極慢。**
解決方案(按推薦順序)
方案一:使用國內鏡像源(最簡單、無需翻牆)
- 打開 SDK Manager → Tools → Options。
- 在 Android SDK Manager - Settings 對話框中:
- 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://...
- 點 Close,然後 Packages → Reload。
常用鏡像地址:
- 中科大:`https://mirrors.ustc.edu.cn/android/repository/`
- 清華:`https://mirrors.tuna.tsinghua.edu.cn/android/repository/`
- 東軟:`https://mirrors.neusoft.edu.cn/android/repository/`
方案二:手動下載離線包安裝(穩妥、適合離線環境)
- 瀏覽器訪問鏡像站 `repository-11.xml` (或 `repository2-1.xml`),找到所需 API 版本、Build Tools、Platform Tools、System Images 下載鏈接 (`.zip`)。
- 下載後解壓到 SDK 目錄對應位置:
- Platforms → `platforms/android-XX`
- Build Tools → `build-tools/XX.X.X`
- System Images → `system-images/android-XX/...`
- Tools → `tools/` / `platform-tools/`
- 重啟 Android Studio / Eclipse ADT,SDK Manager 會識別已安裝包。
方案三:配置代理/VPN(需合法合規網絡環境)
- SDK Manager Options 設置 HTTP/HTTPS Proxy 為本地代理端口 (如 1080/7890)。
- 或系統級代理 (Clash/V2Ray TUN 模式) 全局攔截 Java 進程流量。
方案四:升級至 Android Studio 內建 SDK Manager (現代化)
- Android Studio 2.2+ **內建 SDK Manager** (Tools → SDK Manager),支持斷點續傳、並發下載、鏡像配置更友好。
- 舊版 Eclipse ADT 獨立 SDK Manager 已停止維護,**強烈建議遷移至 Android Studio**。
常見錯誤排查
| 現象 | 原因 | 處理 |
| 「Failed to create directory」 | SDK 目錄無寫入權限 | 以管理員運行 / 修改目錄權限 `chmod 755` |
| 「Package not found」 | 鏡像源索引舊/不全 | 嘗試不同鏡像 / 手動下載離線包 |
| 「ADB server didn't ACK」 | 端口 5037 衝突 | `adb kill-server && adb start-server` |
| Tools 目錄被刪/損壞 | 誤操作/遷移失敗 | 重新下載 `commandlinetools` 解壓覆蓋 `cmdline-tools/latest` |
現代構建系統配置 (Gradle)
// build.gradle (Project)
allprojects {
repositories {
google() // 官方 (需代理)
maven { url 'https://maven.aliyun.com/repository/google/' } // 阿里雲鏡像
maven { url 'https://maven.aliyun.com/repository/jcenter/' }
jcenter()
}
}
// gradle.properties
android.enableJetifier=true
android.useAndroidX=true
總結
SDK Manager 連接失敗核心是**網絡不通**。**「配置國內鏡像源 HTTP Proxy」是零成本、即時生效的首選**;離線環境用「手動下載離線包」;長遠看**「遷移至 Android Studio + Gradle 鏡像配置」是標準化出路**。