Android WebView 디버깅: chrome://inspect Pending authentication 오류 해결

최근 Android 네이티브 앱에서 WebView로 표시되는 페이지의 문제를 확인해야 하는 상황이 있었습니다.

 

iOS의 경우 Mac을 사용하고 있었기 때문에 Safari의 Web Inspector를 이용하면 비교적 간단하게 WebView 디버깅을 진행할 수 있습니다.

Mac에서 Safari의 개발자 메뉴를 활성화한 뒤 iPhone을 연결하면 실행 중인 WebView를 바로 확인하고 디버깅할 수 있기 때문입니다.

 

반면 Android에서는 Chrome DevTools의 Remote Debugging 기능을 사용해야 합니다.

 

Android 기기에서 USB Debugging을 활성화한 뒤 Mac과 USB로 연결하고, Chrome에서 다음 주소로 접속했습니다.

chrome://inspect/#devices

 

정상적으로 연결되면 Android 기기에서 실행 중인 Chrome 탭이나 WebView가 Remote Target 목록에 표시되고, DevTools를 통해 디버깅을 진행할 수 있습니다.

 

하지만 예상과 달리 Remote Target 영역 아래에 다음 메시지만 계속 표시되었습니다.

Pending authentication: please accept debugging session on the device.

 

기기는 인식되고 있었지만 디버깅 세션이 시작되지 않는 상태였습니다.

Pending authentication: please accept debugging session on the device.

---

공식 문서 확인 및 해결 과정

문제를 해결하기 위해 Chrome DevTools 공식 문서도 함께 확인했습니다.

 

공식 문서에서는 다음과 같은 순서로 Android 원격 디버깅을 설정하도록 안내하고 있습니다.

1. Android 기기에서 USB Debugging 활성화
2. USB로 PC와 연결
3. Chrome에서 chrome://inspect/#devices 접속

하지만 이미 위 과정은 모두 진행한 상태였기 때문에 처음에는 무엇이 문제인지 쉽게 파악하기 어려웠습니다.

 

이후 사내 Android 개발자분께 상황을 공유했는데, adb(Android Debug Bridge)가 설치되어 있는지 확인해 보라는 조언을 받았습니다.

 

Mac에는 adb가 설치되어 있지 않았기 때문에 터미널에서 Homebrew를 통해 adb를 설치했습니다.

brew install android-platform-tools

 

설치 후 정상적으로 설치되었는지 확인하기 위해 터미널에서 다음 명령어로 버전을 확인했습니다.

adb version

 

이후 실행 명령을 통해 ADB 서버를 실행했습니다.

adb start-server

 

명령어 실행 이후 Android 기기 화면에 USB 디버깅 허용 팝업이 나타났습니다.

 

USB 디버깅 허용 팝업

 

여기서 허용을 선택하자 DevTools 화면에서도 WebView가 정상적으로 표시되며 디버깅이 가능해졌습니다.

 

DevTools 정상 디버깅 화면

 

결과적으로 ADB가 설치되어 있지 않아 디버깅 인증 과정이 정상적으로 진행되지 않았던 것이었습니다.

---

느낀 점

iOS의 Safari Web Inspector는 비교적 간단한 과정으로 WebView 디버깅을 진행할 수 있지만, Android의 경우 ADB를 통해 디바이스와 연결되는 구조이기 때문에 USB 디버깅 인증 과정이 필요하다는 점을 알게 되었습니다.

 

특히 Pending authentication: please accept debugging session on the device. 메시지는 USB 디버깅을 이미 허용했음에도 계속 표시되었기 때문에, 처음에는 원인을 파악하는 데 시간이 조금 걸렸습니다.

 

결과적으로 Chrome DevTools의 Android 원격 디버깅은 내부적으로 ADB를 통해 디바이스와 통신하기 때문에, ADB가 설치되어 있지 않으면 디버깅 인증 과정이 정상적으로 진행되지 않을 수 있다는 것을 알게 되었습니다.

 

Android WebView 디버깅을 처음 설정하는 경우라면 ADB가 정상적으로 설치되어 있는지 먼저 확인해보는 것도 도움이 될 것 같습니다.