adb device offline: почему устройство offline и что делать

adb devices показывает телефон, но вместо device рядом написано offline:

List of devices attached
R58M123ABC	offline

Статус offline значит, что adb-сервер видит телефон, но стороны не смогли завершить ADB-рукопожатие или соединение оборвалось. Команды вроде adb shell или adb install завершаются ошибкой error: device offline. Ниже причины, от самых частых к редким.

1. Перезапустите adb-сервер

Чаще всего виноват «застрявший» сервер, особенно после того как телефон уснул, перезагрузился или сменил режим USB.

adb kill-server
adb start-server
adb devices

После перезапуска сервера отключите и снова подключите кабель.

2. Разблокируйте телефон и поищите запрос

При первом подключении к компьютеру телефон показывает «Разрешить отладку по USB?». Пока запрос ждёт ответа, некоторые версии adb показывают offline вместо unauthorized. Разблокируйте экран и нажмите «Разрешить». Если запроса нет, зайдите в «Для разработчиков», нажмите «Отозвать доступ для отладки по USB», выключите и снова включите «Отладку по USB» и переподключите телефон.

3. Обновите platform-tools

Старый клиент adb может не договориться с новой версией Android и показать offline. Проверьте версию:

adb version

Если ей несколько лет, скачайте свежие Android SDK platform-tools у Google и проверьте, что PATH не указывает на старую копию (Android Studio, Genymotion и некоторые программы для телефонов ставят свой adb).

4. Две программы делят телефон

Android Studio, scrcpy, программы-менеджеры для телефонов, эмуляторы и фирменные PC-пакеты производителей могут запускать каждый свой adb-сервер. Серверы разных версий постоянно перезапускают друг друга, и телефон переходит в offline. Закройте лишние программы и перезапустите сервер, как в шаге 1. Подробнее в статье устройство занято или unauthorized.

5. Кабель, порт и режим USB

• Попробуйте другой кабель, который точно передаёт данные, и USB-порт прямо на компьютере, а не на хабе.
• На некоторых телефонах помогает переключить режим USB с «Только зарядка» на «Передача файлов» в USB-уведомлении.

6. По Wi-Fi: соединение оборвалось

Телефон, подключённый через adb connect, становится offline, когда засыпает Wi-Fi, меняется IP или выключается «Отладка по Wi-Fi».

adb disconnect 192.168.1.20:5555
adb connect 192.168.1.20:5555

Если в ответ Connection refused, сетевой режим выключен. См. ошибка Connection refused.

7. Перезагрузите телефон

Если ничего не помогло, перезагрузите телефон и компьютер. Это сбросит зависший adbd на телефоне и устаревшее состояние USB-драйверов на компьютере.

Как с этим справляется ADBKit

ADBKit не использует adb-сервер на вашем компьютере. Chrome или Edge общаются с телефоном напрямую через WebUSB, поэтому несовпадение версий сервера не может сделать устройство offline в ADBKit. Но USB-подключение ему нужно целиком: если телефон держит adb-сервер другой программы, ADBKit сообщит, что устройство занято, и подскажет, что закрыть. По Wi-Fi ADBKit показывает понятное состояние «connection lost» и предлагает переподключиться.

Если adb devices вообще ничего не показывает, см. статью adb не видит телефон.