Android "Waiting for Debugger" 무한 대기 현상 해결법

🚨 문제 상황

Android 앱 개발 중 다음과 같은 상황을 경험해보셨나요?

• 디버그 모드가 아닌 일반 실행 상태인데도 "Waiting for Debugger" 메시지가 표시
• 앱이 무한 대기 상태에 빠져 정상적인 테스트 불가
• adb kill-server 및 adb start-server로 ADB를 재시작해도 문제가 지속

🔍 원인 분석

이 현상은 이전에 adb shell am set-debug-app 명령어로 설정된 디버그 앱 설정이 제대로 해제되지 않아 발생합니다. 시스템이 해당 패키지를 여전히 디버그 대상으로 인식하고 있어, 디버거 연결을 기다리는 상태가 지속되는 것입니다.

✅ 해결 방법

다음 ADB 명령어를 실행하여 문제를 해결할 수 있습니다:

adb shell am clear-debug-app

명령어 설명

• clear-debug-app: 이전에 set-debug-app으로 설정된 디버그 앱 설정을 완전히 제거
• 시스템에서 특정 패키지를 디버그 대상으로 인식하지 않도록 초기화

💡 예방 팁

1. 디버그 세션 종료 시: 디버그 작업 완료 후 명시적으로 clear-debug-app 실행
2. 빌드 변경 시: Release 빌드로 전환할 때 디버그 설정 확인
3. 디바이스 변경 시: 새로운 테스트 디바이스 사용 전 디버그 설정 초기화

이 간단한 명령어 하나로 개발 생산성을 크게 향상시킬 수 있습니다. 비슷한 문제를 겪고 계시다면 한 번 시도해보세요! 🚀

레퍼런스

https://jinryua.tistory.com/8
https://developer.android.com/tools/adb?hl=ko