萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

ADB 「waiting for device」 故障排查全流程:從驅動、線纜到授權的標準化檢查清單

執行 adb devices 或安裝應用時長時間提示 waiting for device,意味著 **ADB Server 無法與設備建立有效連接**。本文提供標準化 6 步排查清單,覆蓋驅動、硬件、授權、模式、服務、環境變量全鏈路,助你快速定位並解決連接故障。

一、 現象解讀

  • waiting for device:ADB Server (默認 5037 端口) 未檢測到**在線且授權**的設備 (實體機或模擬器)。
  • 常見於:adb install, adb shell, adb logcat, adb push/pull 等命令隱式調用連接時。

二、 標準排查 6 步走 (按成功率排序)

1. 核對 USB 調試開關與授權狀態 (最高頻)

  • 設置 → 開發者選項 → **USB調試 開啟**。
  • 插線後手機彈出 **「允許USB調試?」** 對話框,**必須點擊「確定」/「始終允許」**。
  • 若無彈窗:撤銷 USB 調試授權 (開發者選項 → 撤銷USB調試授權) → 重新插拔 → 等待彈窗授權。
  • 檢查 adb devices 輸出:device (正常) vs unauthorized (未授權) vs offline (連接異常)。

2. 驅動程序安裝與識別 (Windows 核心痛點)

  • 設備管理器 → 便攜設備/其他設備 → 確認顯示設備名稱 (非「未知設備」「ADB Interface」黃色驚嘆號)。
  • 安裝官方 OEM 驅動 (Google Pixel 用 Google USB Driver,其他廠商去官網下載) 或通用驅動 (如 驅動精靈/駿昇/ADB Driver Installer)。
  • 刷機/救磚模式 (Fastboot/EDL/Recovery) 需**單獨驅動** (通常包含在 OEM 包內或 SDK extras/google/usb_driver)。

3. 硬件物理連接排查

  • 數據線:必須支持**數據傳輸** (純充電線無數據引腳);優先原廠/優質線材;嘗試更換線材。
  • USB 口:台式機**強制使用機箱後置主板直連 USB 口** (供電足、信號穩);避免前置面板/擴展塢/鍵盤接口。筆記本嘗試不同側邊口。
  • 手機 USB 口:檢查是否鬆動、氧化、異物;嘗試吹氣/清理。

4. ADB 服務狀態重置

adb kill-server
adb start-server
# 或
adb kill-server
adb devices  # 自動啟動 server

若報錯 cannot bind 'tcp:5037':端口被佔用 (如 Genymotion, 360手機助手, 豌豆莢等)。
解決:任務管理器結束佔用進程 / 修改 ADB 端口 (環境變量 ADB_LOCAL_TRANSPORT_MAX_PORT) / 關閉衝突軟件。

5. 連接模式與授權模式確認

  • MTP / PTP / 僅充電:下拉通知欄 USB 選項,**選擇「文件傳輸 (MTP)」或「傳輸照片 (PTP)」**,「僅充電」通常禁用 ADB。
  • 無線 ADB (Android 11+):設置 → 開發者選項 → 無線調試 → 配對碼/二維碼連接。adb pair ip:port → adb connect ip:port。

6. 環境變量與多版本衝突

  • 確認 PATH 中 **只有一個** platform-tools 路徑 (SDK 目錄下)。多版本導致調用錯誤版本 adb.exe。
  • IDE (Android Studio/VS Code) 內置 ADB 可能與系統 PATH 版本不一致。IDE 設置指定 SDK 路徑統一版本。

三、 進階診斷命令

adb version                    # 確認版本
adb devices -l                 # 顯示產品/型號/傳輸ID
adb get-state                  # 狀態: device/offline/unknown
adb usb                        # 列出 USB 設備詳情
adb logcat -d | head -20       # 看日誌是否通 (需已連接)
# Windows: 查看 USB 設備樹
# devmgmt.msc -> 視圖 -> 按連接查看 -> 通用串行總線控制器 -> 查看設備屬性 -> 事件

四、 常見誤區避雷

  • ❌ 以為安裝了「手機助手」就有驅動 → 助手自帶驅動可能與 SDK 衝突,**需單獨安裝 OEM 驅動**。
  • ❌ 以為「充電」就能 ADB → 必須選 MTP/PTP 並授權。
  • ❌ 以為 unauthorized 是驅動問題 → **純授權問題,換線/換口無用,看手機屏幕授權**。
  • ❌ 以為 offline 是設備壞了 → 多半是 ADB Server/驅動/授權狀態不同步,**kill-server 重試**。

五、 總結

waiting for device = **連接鏈路任意一環斷裂**。
按順序驗證:**授權狀態 → 驅動識別 → 數據線/USB口 → ADB服務 → USB模式 → 環境變量**。
90% 以上情況在前 3 步解決。保持耐心,逐項排查,必有結果。

copyright © 萬盛學電腦網 all rights reserved