이 글의 핵심
무선 디버깅 페어링 실패 시 같은 Wi-Fi, 페어링 코드, adb 상태와 USB 초기 연결 등을 순서대로 확인합니다.
PC와 휴대폰 네트워크 확인
두 기기가 같은 로컬 네트워크에 있는지 먼저 확인합니다. 회사나 공용 Wi-Fi는 기기 간 통신을 막는 경우가 있어 같은 SSID라도 연결이 되지 않을 수 있습니다. 이런 환경에서는 USB 디버깅이 더 안정적입니다.
페어링 주소와 연결 주소 구분
안드로이드 무선 디버깅 화면에는 페어링용 IP:포트와 실제 디버깅 연결용 IP:포트가 따로 표시될 수 있습니다. adb pair에는 페어링 주소를 사용하고, 페어링 이후 adb connect에는 연결 주소를 사용해야 합니다.
adb 상태 초기화
이전 연결이 꼬였다면 adb kill-server 후 adb start-server로 다시 시작하고 기기 목록을 확인합니다. 여러 Android SDK의 adb가 PATH에 섞여 있으면 예상과 다른 버전이 실행될 수 있으므로 실제 사용 중인 SDK 경로도 확인합니다.
USB를 백업 방법으로 사용
무선 연결이 계속 실패하면 USB로 한 번 정상 승인하고 Flutter 실행이 되는지 확인하세요. 앱 자체 문제가 아니라 네트워크 페어링 문제라는 것을 분리할 수 있습니다. 개발 중 안정성이 중요할 때는 USB를 기본으로 쓰고 무선은 편의 기능으로 사용하는 것도 좋은 선택입니다.