Xcode "Waiting to reconnect ..." 오류 해결하기

Xcode에서 발생하는 "Waiting to reconnect ..." 오류에 대해, 원인부터 해결하기 위해 시도할 수 있는 방법들을 자세히 소개합니다. 실제 경험에 비춰 실질적으로 도움이 되는 해결 방안을 살펴봅니다.

문제 발생 배경

어제까지는 문제없이 잘 사용하던 Xcode에서 갑자기 "Waiting to reconnect to iPhone" 메시지가 나타나면서 디바이스로 앱을 실행할 수 없게 되었습니다. 과거 경험했던 비슷한 오류들 "iPhone is not available", "Please reconnect the device" 때 경험을 바탕으로 여러 시도도 해보고, 검색해서 비슷한 사례를 찾아보기도 했습니다. "Waiting to reconnect to iPhone" 오류에 대한 검색 결과가 많지도 않았고 그나마 찾은 글들도 제 경우에는 도움이 되지 않았습니다.

오류 메시지 분석

"Waiting to reconnect ..." 오류란?

Xcode에서 발생한 "Waiting to reconnect to ..." 오류

 

Xcode에서 "Waiting to reconnect to [디바이스 이름]"이라는 메시지는 디바이스와의 연결이 끊어졌거나, 디바이스가 정상적으로 인식되지 않을 때 나타나는 오류입니다. 위 이미지와 같이 Xcode에 "Waiting to reconnect to [디바이스 이름]" 메시지가 계속해서 보이며, 디바이스로 Run을 해볼 수 없는 상태가 됩니다.

문제 해결을 위해 시도할 수 있는 방법

이 오류를 해결하기 위해 제가 시도한 방법은 5가지 였습니다. 

방법 1. 기본적인 재부팅 및 재연결, 그리고 케이블 상태 확인

먼저 시도한 방법은 가장 기본적인 재부팅과 재연결이었습니다. Xcode와 iPhone을 모두 재부팅하고, USB 케이블을 다시 연결하여 문제가 해결되는지 확인했습니다. 또 연결한 케이블이 이상이 없는지 확인하고 다른 케이블로도 시도를 해보았습니다.

방법 2. Xcode 캐시 및 Derived Data 삭제

Xcode에서 문제가 발생하면 가장 많이 시도해보는 조치이죠.

1. Xcode 종료: 모든 Xcode 창을 닫고 완전히 종료합니다.
2. Derived Data 삭제: Finder에서 ~/Library/Developer/Xcode/DerivedData 폴더로 이동하여 모든 파일과 폴더를 삭제합니다.
3. iOS DeviceSupport 삭제: Finder에서 ~/Library/Developer/Xcode/iOS DeviceSupport 폴더로 이동하여 내용을 삭제합니다.
4. Xcode 캐시 삭제: Finder에서 ~/Library/Caches/com.apple.dt.Xcode 폴더와 ~/Library/Preferences/com.apple.dt.Xcode.plist 파일을 삭제합니다.

이 과정을 거친 후 Xcode를 다시 실행해서 Run을 시도합니다.

방법 3. 아이폰에서 신뢰하는 컴퓨터 초기화하기

Mac과 아이폰의 연결에 문제가 있을 수 있으니, 다음의 방법으로 아이폰에서 신뢰하는 Mac 정보를 초기화 해주었습니다.

1. 아이폰과 Mac 연결 해제
2. 아이폰 설정 > 개발자 > 신뢰하는 컴퓨터 지우기 클릭
3. 아이폰을 다시 Mac에 연결
4. 이 Mac을 신뢰하겠냐는 팝업이 뜨면 신뢰 클릭

이 과정을 거친 후 Xcode에서 정상 여부를 확인합니다. 

방법 4. Xcode에서 연결 기기 Unpair 및 재연결하기

'방법 3'이 아이폰에서 Mac을 해제했다가 다시 연결한 방법이라면, '방법 4'는 Mac에서 아이폰들을 연결 해제하는 방법입니다. 

1. Xcode에서 Window > Devices and Simulators 를 선택
2. Devices and Simulators 창에서 디바이스를 Unpair한 후, 다시 연결

방법 5. 네트워크 연결 변경하기

위 방법들을 시도해봤으나 제 경우에는 해결되지 않았습니다. 그러다 '방법 4'를 시도하던 중, Devices and Simulators 창에 떠있는 상세 오류 메시지를 확인할 수 있었습니다. 

Waiting to reconnect to.. 오류의 원인이 네트워크 문제임을 알려주는 상세 메시지

 

오류 메시지에 포함된 "A networking error occurred." 부분이 단서가 될 수 있음을 깨달았습니다. 네트워크가 디바이스와 Xcode 간의 통신에 영향을 미칠 수 있다는 점을 고려하여, 네트워크 설정을 점검하기로 결정했습니다.

 

Mac에 연결된 와이파이를 변경한 후, 다시 Xcode에서 디바이스를 연결해 보니 문제가 해결되었습니다. 기존 네트워크에 데이터 제한이 있었거나, 특정 포트가 차단되어 있었던 것으로 추정됩니다. 와이파이를 변경함으로써 Xcode가 필요한 파일을 성공적으로 다운로드하고 디바이스에 마운트할 수 있게 되었습니다.

 

어제까지 개발에 문제가 없던 작업 환경이었기 때문에 네트워크가 원인일거라고 미쳐 생각하지 못했는데요. 가장 기본적이지만, 오류 메시지를 잘 확인해보는 것이 문제 해결의 가장 큰 단서라는 것을 다시 한번 느끼게 되었습니다.

해결 후 느낀 점과 팁

문제 해결을 위한 팁

• 오류 메시지를 꼼꼼히 읽고, 단서를 찾는 것이 중요합니다.
• 기본적인 재부팅과 캐시 삭제는 항상 첫 번째 시도해볼 만한 방법입니다.
• 네트워크 환경도 중요한 요소이므로, 문제가 지속될 경우 네트워크 설정을 점검해보세요.

유사 문제 예방 방법

• 정기적으로 Xcode와 macOS를 최신 버전으로 업데이트하세요.
• 안정적인 네트워크 환경을 유지하고, 데이터 제한이나 방화벽 설정을 점검하세요.
• 개발 중인 디바이스와 Mac 간의 연결 상태를 주기적으로 확인하세요.
• 중요한 프로젝트는 항상 백업을 유지하여 데이터 손실을 방지하세요.

마무리하며

Xcode에서 발생하는 "Waiting to reconnect ..." 오류는 다양한 원인으로 인해 발생할 수 있습니다. 이번 글에서 소개한 해결 방법들을 하나씩 해보면 해결에 도움이 될 것이라 생각합니다. 특히 네트워크 문제가 원인일 수 있다는 점을 염두에 두고, 문제가 발생했을 때 네트워크 설정을 먼저 점검해보는 것이 좋겠습니다. 제가 직접 겪은 경험을 바탕으로 한 것이지만, 위 방법들이 많은 개발자들에게도 도움이 되기를 바랍니다.