首頁
編程語言
C語言|JAVA編程
Python編程
網頁編程
ASP編程|PHP編程
JSP編程
數據庫
MYSQL數據庫|SqlServer數據庫
Oracle數據庫|DB2數據庫
您现在的位置: 程式碼之家 >> 編程語言 >  >> 更多程式語言 >> 程式設計綜合問答

Android SDK Manager 配置失敗:連接谷歌服務器超時的解決方案

     編輯:程式設計綜合問答

問題現象

SDK Manager 打開顯示「Fetching URL...」長時間無響應,或報錯「Failed to fetch URL... Connection timed out」,可用包列表為空/灰色不可選。

根因

**Android SDK Manager 默認訪問 `dl.google.com` / `dl-ssl.google.com` 下載包索引與文件,國內網絡環境無法直連或極慢。**

解決方案(按推薦順序)

方案一:使用國內鏡像源(最簡單、無需翻牆)

  1. 打開 SDK Manager → Tools → Options。
  2. 在 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://...
  3. 點 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/`

方案二:手動下載離線包安裝(穩妥、適合離線環境)

  1. 瀏覽器訪問鏡像站 `repository-11.xml` (或 `repository2-1.xml`),找到所需 API 版本、Build Tools、Platform Tools、System Images 下載鏈接 (`.zip`)。
  2. 下載後解壓到 SDK 目錄對應位置:
    • Platforms → `platforms/android-XX`
    • Build Tools → `build-tools/XX.X.X`
    • System Images → `system-images/android-XX/...`
    • Tools → `tools/` / `platform-tools/`
  3. 重啟 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 鏡像配置」是標準化出路**。

  1. 上一篇文章:
  2. 下一篇文章:
Copyright © 程式碼之家 All Rights Reserved