Eclipse / Android Studio 部署 App 到真機時,Console 輸出:
[2012-09-18 09:36:48 - myapp] Failed to upload myapp.apk on device 'HT01TP800561'
[2012-09-18 09:36:48 - myapp] java.io.IOException: Unable to open sync connection!
[2012-09-18 09:36:48 - myapp] Launch canceled!
這表示 **adb 與裝置的同步通道建立失敗**,通常是 USB 連線品質、驅動程式或 adb 服務狀態問題。
adb kill-server
adb start-server
# 或
adb usb
# 查看連線裝置
adb devices -l
# 查看 adb 版本
adb version
# 檢查同步狀態
adb shell sync
# 監控 adb log
adb logcat -d | tail -50
| 環境 | 已知原因 | 解法 |
|---|---|---|
| Ubuntu/Linux | udev 規則缺失、權限不足 | 建立 /etc/udev/rules.d/51-android.rules、將用戶加入 plugdev 群組 |
| Windows 10/11 | 驅動衝突、快速啟動鎖定 USB | 關閉快速啟動、重裝通用 ADB 驅動 |
| 虛擬機 (VMware/VirtualBox) | USB 傳遞不穩 | 設定 USB 3.0 控制器、重新連接裝置到 VM |
| Android 11+ | 無線偵錯衝突 | 關閉無線偵錯、優先有線 |
若 USB 持續不穩,改用 **Wi-Fi 無線偵錯**:
adb pair ip:port → 輸入配對碼 → adb connect ip:port無線偵錯避免實體線材問題,現代開發強烈建議作為主要或備用方案。