오늘은 React Native 프로젝트를 진행하면서 마주칠 수 있는 “Could not connect to development server” 오류의 해결 방법에 대해 이야기해보려 합니다.
이 오류는 개발 중인 앱을 실제 스마트폰에서 실행할 때 자주 발생하는데요, 에뮬레이터에서는 잘 작동하는 앱이 실제 디바이스에서는 연결 오류를 보이곤 합니다. 저 역시 이 문제로 한참을 고민한 끝에 해결책을 찾았습니다.
문제 상황
React Native 프로젝트를 생성하고 App.tsx 파일을 수정한 뒤, Android Studio에서 에뮬레이터로 실행하면 정상적으로 앱이 작동합니다. 그러나 실제 스마트폰을 연결하여 실행할 때는 “Could not connect to development server“라는 오류 메시지가 나타나며, 앱이 실행되지 않는 문제가 발생했습니다.
문제의 원인
이 문제의 원인은 실제 스마트폰이 개발 서버에 연결되기 위해선, 개발 중인 PC의 IP 주소를 명확히 지정해주어야 한다는 것이었습니다. 기본적으로 http://localhost:8081로 설정되어 있는 개발 서버 주소는 실제 디바이스에서는 작동하지 않습니다.
해결 방법
1. IP 주소 확인: 먼저, ipconfig (윈도우의 경우) 또는 ifconfig (맥이나 리눅스의 경우) 명령을 통해 현재 사용 중인 PC의 IP 주소를 확인합니다.
2. 개발 서버 시작: 그 다음, 리액트 프로젝트 디렉토리에서 터미널을 열고 ‘npx react-native start’ 명령을 실행하여 개발 서버를 시작합니다.
3. 안드로이드 스튜디오에서 프로젝트 실행: 이제 안드로이드 스튜디오에서 프로젝트를 실행합니다.
4. 스마트폰에서 IP 주소 입력: 마지막으로, 스마트폰에서 앱을 실행할 때 확인한 PC의 IP 주소와 포트 번호 8081을 입력하여 개발 서버에 연결합니다. 예를 들어, PC의 IP 주소가 192.168.0.5라면, 스마트폰에서는 192.168.0.5:8081로 접근해야 합니다.
결론
“Could not connect to development server” 오류는 개발 서버의 주소를 정확히 지정해주지 않아 발생하는 문제입니다. 실제 디바이스에서 앱을 테스트하려면, 위에서 설명한 단계를 따라 PC의 IP 주소를 앱에 입력해주어야 합니다. 이 글이 여러분이 같은 오류를 마주쳤을 때 도움이 되기를 바랍니다.
