Что значит ошибка "USB-отладка не работает"
Вы подключаете Android-устройство к компьютеру для разработки или использования ADB-команд, но система не обнаруживает телефон. В командной строке adb devices выводит пустой список или устройство со статусом unauthorized. Android Studio или другие IDE не показывают подключённое устройство. Проблема может проявляться на любом этапе: от физического соединения до программного уровня.
Причины возникновения
- Неподходящий USB-кабель или порт. Многие кабели рассчитаны только на зарядку и не имеют линий данных. Порт на компьютере или сам кабель могут быть неисправны.
- Отключена опция "Отладка по USB" на самом устройстве или не включены "Опции разработчика".
- Не получено разрешение на отладку. При первом подключении на экране телефона должно появиться диалоговое окно с запросом разрешения отладки от данного компьютера. Если его не было, или нажали "Отклонить", ADB не сможет подключиться.
- Устаревшие или отсутствующие драйверы ADB (особенно актуально для Windows). Система видит устройство как непонятное "Android" или "ADB Interface" с восклицательным знаком.
- Конфликт с другим ПО. Некоторые программы (например, Samsung Smart Switch, HTC Sync) могут перехватывать управление устройством и блокировать ADB.
- Сбой в службе ADB. Процесс
adb.exeможет "зависнуть" или работать некорректно. - Неверный режим USB-подключения на телефоне. По умолчанию после подключения кабеля телефон может перейти в режим "Только зарядка". Нужно вручную выбрать "Передача файлов (MTP)" или "PTP".
Способы решения
Способ 1: Базовая проверка кабеля и режима USB
Это самый частый и простой источник проблем.
- Используйте гарантированно рабочий USB-кабель, который точно поддерживает передачу данных (оригинальный кабель от телефона — лучший вариант).
- Подключите кабель непосредственно к порту на системном блоке/ноутбуке, избегая USB-хабов и фронтальных портов (они иногда слабее).
- На телефоне, после подключения кабеля, опустите шторку уведомлений и нажмите на уведомление о USB-подключении. Выберите режим "Передача файл (MTP)" или "PTP". Иногда выбор правильного режима "разблокирует" ADB.
- После смены кабеля/режима проверьте
adb devicesвновь.
Способ 2: Настройка устройства и авторизация
Убедимся, что на телефоне всё включено правильно.
- Перейдите в Настройки → Об устройстве → Номер сборки. Нажмите на него 7 раз, пока не появится сообщение "Вы стали разработчиком!".
- Вернитесь в основные настройки. Откройте "Опции разработчика" (обычно внизу).
- Включите переключатель "Отладка по USB".
- (Рекомендуется) Также включите "Авторизация компьютера" (если есть).
- Подключите телефон к компьютеру. Внимательно посмотрите на экран телефона. Должно появиться окно с запросом разрешения отладки. Нажмите "Разрешить" и, желательно, поставьте галочку "Всегда разрешать с этого компьютера".
- Если окно не появилось, отключите и снова подключите USB-кабель, предварительно выключив и включив на телефоне "Отладку по USB".
Способ 3: Установка и обновление драйверов (Windows)
Если вы работаете под Windows, драйверы — это 80% проблем.
- Откройте Диспетчер устройств (Win + R →
devmgmt.msc). - Найдите в списке ваше устройство. Оно может быть в разделе "Портативные устройства" (с названием модели телефона) или "Другие устройства" (с жёлтым восклицательным знаком, например, "Android" или "ADB Interface").
- Щёлкните правой кнопкой мыши на устройстве → "Обновить драйверы".
- Выберите "Выполнить поиск драйверов на этом компьютере" → "Выбрать драйвер из списка доступных драйверов".
- Укажите путь к папке с драйвером. Официальный драйвер Google USB Driver можно установить через Android Studio → SDK Manager → SDK Tools → Google USB Driver. Или скачать отдельно.
- Если драйвер установлен, но не работает, попробуйте удалить устройство из Диспетчера (с галочкой "удалить программы драйверов для этого устройства"), а затем повторно подключить телефон — Windows запросит драйвер заново.
- Альтернатива: используйте универсальные драйверы, такие как PDAnet или Universal ADB Driver. Они часто лучше распознают устройства от разных производителей.
Способ 4: Чистый перезапуск ADB и системы
Иногда помогает просто "перезагрузить" процесс.
- Закройте все IDE (Android Studio, VS Code) и программы, использующие ADB.
- Откройте командную строку (cmd) или PowerShell.
- Выполните команды последовательно:
adb kill-server adb start-server adb devices - В последней команде вы должны увидеть список устройств. Если устройство появилось со статусом
unauthorized, вернитесь к Способу 2. - Если не помогло, перезагрузите и телефон, и компьютер.
- После перезагрузки сначала включите на телефоне "Отладку по USB", а уже потом подключайте кабель.
Способ 5: Отключение конфликтующего ПО
Некоторые утилиты от производителей телефонов (Samsung Smart Switch, Xiaomi PC Suite, HTC Sync) могут перехватывать управление.
- Полностью закройте такие программы в системном трее (рядом с часами).
- Удалите их из автозагрузки (через Диспетчер задач или msconfig).
- Перезапустите ADB (Способ 4).
- Если проблема ушла, настройте работу ПО так, чтобы оно не запускалось автоматически при подключении телефона.
Профилактика
- Используйте качественный USB-кабель. Не экономьте на кабеле для разработки.
- Обновляйте драйверы и Android SDK. Регулярно запускайте SDK Manager и устанавливайте обновления, включая "Google USB Driver".
- Включайте опцию "Всегда разрешать" при первом запросе авторизации на телефоне. Это избавит от необходимости подтверждать при каждом подключении.
- Проверяйте режим USB. При подключении к новому компьютеру или после сброса настроек телефона режим может сбрасываться на "Только зарядка".
- На Windows используйте стабильные версии драйверов. После крупных обновлений системы (например, обновление Windows 10 → 11) драйверы ADB могут перестать работать и потребовать переустановки.
Частые дополнительные проблемы
Симптом: adb devices показывает устройство как offline.
Решение: Чаще всего это проблема авторизации (Способ 2). Убедитесь, что вы нажали "Разрешить" на телефоне. Если не помогло, перезапустите ADB и телефон.
Симптом: Устройство определяется в Диспетчере устройств как "MTP" или "PTP", но adb devices его не видит.
Решение: Установите драйвер ADB вручную (Способ 3), даже если Windows ставит драйвер для MTP автоматически. Это разные драйверы.
Симптом: После обновления Android (особенно на Xiaomi/POCO) отладка перестала работать. Решение: В новых версиях MIUI/Android могут быть дополнительные настройки. Проверьте, не включена ли опция "Установка через USB" (в "Опциях разработчика") или не требуется ли дополнительное разрешение от антивируса/фоновых ограничений.