fastlane에서 Unexpected Error로 iOS 앱을 제출할 수 없는 문제 해결하기

문제 상황

• fastlane 배포 파이프라인의 App Store Connect 메타데이터 업로드 단계에서 Unexpected Error 발생
• 재시도와 로컬 실행에서도 동일하게 재현되어 iOS 앱 릴리즈 지연

원인 분석

• --verbose 로그의 Spaceship::Tunes::PotentialServerError와 API 500 응답 확인
• 서버 상태, fastlane 버전, 빌드 머신, 프로젝트 설정, 계정 권한을 순차적으로 배제
• 메타데이터 파일 이진 탐색으로 trade_representative_contact_information/country.txt 식별

해결 방법

• country.txt 파일 제거 시 오류가 사라지는 점으로 국가 표기값 유효성 문제 확인
• deliver download_metadata로 최신 메타데이터 내려받기
• 기존 Korea, Republic Of 값을 South Korea로 변경 후 업로드 성공

주의할 점

• 메타데이터 내용 삭제와 파일 삭제가 서로 다른 결과를 낼 수 있는 fastlane 처리 방식
• 비공식 App Store Connect API 의존에 따른 국가명 표기 변경 가능성