執行 adb devices 或安裝應用時長時間提示 waiting for device,意味著 **ADB Server 無法與設備建立有效連接**。本文提供標準化 6 步排查清單,覆蓋驅動、硬件、授權、模式、服務、環境變量全鏈路,助你快速定位並解決連接故障。
waiting for device:ADB Server (默認 5037 端口) 未檢測到**在線且授權**的設備 (實體機或模擬器)。adb install, adb shell, adb logcat, adb push/pull 等命令隱式調用連接時。adb devices 輸出:device (正常) vs unauthorized (未授權) vs offline (連接異常)。extras/google/usb_driver)。adb kill-server
adb start-server
# 或
adb kill-server
adb devices # 自動啟動 server
若報錯 cannot bind 'tcp:5037':端口被佔用 (如 Genymotion, 360手機助手, 豌豆莢等)。
解決:任務管理器結束佔用進程 / 修改 ADB 端口 (環境變量 ADB_LOCAL_TRANSPORT_MAX_PORT) / 關閉衝突軟件。
adb pair ip:port → adb connect ip:port。PATH 中 **只有一個** platform-tools 路徑 (SDK 目錄下)。多版本導致調用錯誤版本 adb.exe。adb version # 確認版本
adb devices -l # 顯示產品/型號/傳輸ID
adb get-state # 狀態: device/offline/unknown
adb usb # 列出 USB 設備詳情
adb logcat -d | head -20 # 看日誌是否通 (需已連接)
# Windows: 查看 USB 設備樹
# devmgmt.msc -> 視圖 -> 按連接查看 -> 通用串行總線控制器 -> 查看設備屬性 -> 事件
unauthorized 是驅動問題 → **純授權問題,換線/換口無用,看手機屏幕授權**。offline 是設備壞了 → 多半是 ADB Server/驅動/授權狀態不同步,**kill-server 重試**。waiting for device = **連接鏈路任意一環斷裂**。
按順序驗證:**授權狀態 → 驅動識別 → 數據線/USB口 → ADB服務 → USB模式 → 環境變量**。
90% 以上情況在前 3 步解決。保持耐心,逐項排查,必有結果。