크래시 보고서에 주소만 표시되거나 호출 스택 일부를 읽을 수 없습니다.
먼저 문제가 생긴 빌드의 Xcode Archive를 찾고, 보고서의 바이너리 UUID와 그 Archive의 dSYM UUID를 대조하세요. 일치하지 않는다면 다른 빌드의 dSYM이나 다시 만든 파일로 대신하지 마세요.
독립 개발자: App Store 또는 TestFlight로 배포한 앱의 크래시 보고서를 받은 경우에 적합합니다.
소규모 팀의 배포 담당자: 배포별 Archive와 dSYM이 함께 보관되고 복구 가능한지 점검할 수 있습니다.
원격 Mac 또는 CI 유지관리자: 빌드 산출물이 저장되고 전달된 뒤에도 검색되는지 확인할 수 있습니다.
최종 확인: 2026년 11월 1일. Xcode 27.2 RC의 배포 상태와 날짜는 Apple Developer의 릴리스 목록에서 확인할 수 있습니다. 해당 목록에는 2026년 10월 19일 RC 배포가 표시됩니다. 이는 RC 상태를 확인하는 근거이며, 이 버전에 dSYM 문제가 널리 발생한다는 근거는 아닙니다.
01 Xcode 27.2 RC dSYM 누락은 증상부터 나눠 확인합니다
dSYM 파일이 실제로 없는 경우와 파일은 있지만 심볼화가 되지 않는 경우는 다른 문제입니다. 크래시 보고서가 주소나 기계어 수준의 위치를 보여준다면 먼저 해당 보고서가 가리키는 앱 빌드와 바이너리를 확인하세요. Xcode가 심볼 파일을 찾지 못했다는 메시지를 표시해도, 그것만으로 Xcode 27.2 RC의 일반적인 결함이라고 단정할 수 없습니다.
Apple은 크래시 보고서의 JSON 형식과 바이너리 정보를 확인하는 방법을 크래시 보고서 형식 문서에서 설명합니다. 보고서의 앱 이름만 보지 말고 문제가 발생한 빌드와 바이너리 식별 정보를 함께 확인해야 합니다.
| 관찰한 상태 | 먼저 확인할 증거 | 다음 조치 |
|---|---|---|
| 호출 스택 대부분이 주소로 표시됨 | 보고서의 앱 빌드와 주 앱 바이너리 UUID | 해당 빌드의 Archive에서 주 앱 dSYM을 찾습니다 |
| 특정 프레임워크 구간만 읽히지 않음 | 읽히지 않는 프레임이 속한 바이너리 | 앱, 시스템 프레임워크, 서드파티 프레임워크를 구분합니다 |
| dSYM을 찾았지만 심볼화가 되지 않음 | 보고서와 후보 dSYM의 UUID | UUID가 다르면 그 파일을 사용하지 않습니다 |
| App Store Connect에는 빌드가 표시됨 | 로컬 Archive와 dSYM의 보관 여부 | 플랫폼에 표시되는 빌드 정보와 원본 보관물을 별도로 점검합니다 |
02 첫 번째 단계: Xcode Archive에서 해당 빌드를 찾습니다
Xcode Archive는 빌드한 앱의 보관 자료입니다. Apple은 디버깅 정보 빌드 설정과 Archive에 포함되는 산출물을 디버깅 정보를 포함하도록 빌드하는 문서에서 안내합니다. 문제가 발생한 배포물과 일치하는 Archive가 있는지 먼저 확인하세요.
- [ ] Xcode의 Organizer에서 문제가 발생한 배포에 해당하는 Archive를 확인합니다.
- [ ] 저장한 Archive가 있다면 내부에서 주 앱의 dSYM을 찾습니다.
- [ ] 앱 확장이나 별도 프레임워크를 사용했다면 각 구성 요소의 dSYM도 확인합니다.
- [ ] 파일 이름뿐 아니라 파일이 어느 빌드에서 생성됐는지 식별할 정보를 함께 기록합니다.
- [ ] Archive가 없다면 다른 빌드의 결과물을 대신 쓰지 말고, 아래 UUID 확인 단계로 넘어갑니다.
같은 소스 코드로 다시 빌드해도 기존 앱과 동일한 바이너리라는 보장은 없습니다. 새 빌드에서 만들어진 dSYM은 새 바이너리에 대응하는 파일입니다. 따라서 기존 배포물에 발생한 크래시를 분석할 때 재빌드한 dSYM이 원래 파일을 자동으로 대체하지 않습니다. Apple의 누락된 디버그 심볼 파일 찾기 안내도 누락된 심볼 파일을 해당 빌드의 자료와 연결해 점검하도록 설명합니다.
Xcode 27.2 RC에서 생성된 dSYM은 어디서 찾을 수 있나요?
우선 Organizer에서 해당 빌드의 Archive를 찾으세요. Archive를 별도로 내보내거나 팀 저장소에 보관했다면 그 복사본도 확인합니다. 주 앱뿐 아니라 확장과 포함된 프레임워크의 심볼 파일이 필요할 수 있습니다. 파일 이름에 앱 이름이나 버전이 들어 있다는 이유만으로 올바른 파일이라고 판단하지 마세요. 보고서의 바이너리 UUID와 실제 파일의 UUID를 확인해야 합니다.
03 두 번째 단계: dSYM UUID와 크래시 보고서의 UUID를 대조합니다
같은 이름의 파일을 찾는 것과 해당 빌드의 심볼 파일을 찾는 것은 다릅니다. 심볼화가 실패하면 보고서에서 분석할 바이너리의 UUID를 확인하고, 후보 dSYM이 그 UUID와 일치하는지 대조하세요. Apple의 누락된 심볼 파일 위치 확인 문서는 dSYM의 UUID를 확인하고 필요한 파일을 찾는 경로를 다룹니다.
대조할 때는 먼저 보고서에서 앱 바이너리 또는 문제가 발생한 구성 요소를 식별합니다. 그런 다음 같은 구성 요소에 해당하는 dSYM을 고릅니다. 앱 확장이나 프레임워크의 심볼을 앱 본체의 UUID와 비교하면 일치하지 않는 것이 정상일 수 있습니다. 비교 대상이 같은 바이너리인지부터 확인하세요.
UUID가 일치하지 않을 때는 어떻게 하나요?
해당 dSYM을 사용한 심볼화를 중단하고 다른 후보 파일을 찾으세요. UUID가 다르면 그 파일은 보고서가 가리키는 바이너리에 대응하지 않습니다. 이름을 바꾸거나 파일을 다른 Archive에 넣어도 UUID가 같아지지는 않습니다. 문제가 생긴 배포 시점의 Archive, 빌드 기록, 전달된 산출물을 다시 찾아야 합니다.
해당 Archive가 남아 있지 않고 UUID가 일치하는 심볼 파일도 없다면, 기존 빌드의 심볼화를 복구하지 못할 수 있습니다. 새로 빌드한 결과물은 원래 배포물의 디버그 정보를 대신하지 않습니다. 이 지점에서는 잘못된 심볼 파일을 계속 시험하기보다, 보관된 자료가 더 있는지 확인한 뒤 복구 한계를 기록하는 편이 안전합니다. Apple은 크래시 보고서에 심볼 이름을 연결하는 흐름을 크래시 보고서 심볼화 문서에서 안내합니다.
04 일부 프레임만 읽히지 않으면 바이너리 출처를 나눕니다
전체 호출 스택이 아니라 특정 구간만 심볼화되지 않는다면, 모든 빌드 자료가 손상됐다고 결론 내릴 필요는 없습니다. 읽히지 않는 프레임이 어느 바이너리에 속하는지 나누고, 그 파일에 대응하는 심볼을 확인하세요.
- 앱이나 앱 확장 코드라면 해당 배포의 Archive와 구성 요소별 dSYM을 확인합니다.
- 시스템 프레임워크 구간이라면 해당 기기와 운영 체제에 맞는 기호 자료가 있는지 확인합니다. 앱의 dSYM을 시스템 프레임워크 심볼 대신 적용하지 마세요.
- 서드파티 프레임워크 구간이라면 공급자가 제공한 dSYM이 해당 바이너리와 일치하는지 확인합니다.
- 프레임의 출처를 판별하지 못했다면 추측으로 다른 심볼 파일을 적용하지 말고, 보고서의 바이너리 정보를 먼저 확인합니다.
이 구분은 조사 범위를 좁혀 줍니다. 예를 들어 앱 코드의 프레임이 읽히는데 특정 서드파티 구성 요소만 주소로 남는다면, 앱 Archive 전체를 다시 만드는 것보다 해당 구성 요소의 배포 심볼 자료를 확인하는 편이 직접적인 다음 단계입니다.
05 App Store Connect의 빌드 표시는 로컬 Archive 보관 증거가 아닙니다
App Store Connect에서 빌드를 확인할 수 있다는 사실만으로 개발자가 원본 Archive와 그 안의 모든 dSYM을 계속 보유하고 있다고 볼 수는 없습니다. 플랫폼의 빌드 정보, 분배 과정에서 전달된 심볼 자료, 팀이 로컬이나 별도 저장소에 보관한 Archive는 서로 다른 확인 대상입니다.
App Store Connect의 빌드 정보와 메타데이터 확인 범위는 빌드 및 메타데이터 보기 문서에서 확인할 수 있습니다. 앱에 해당하는 빌드가 목록에 있더라도, 문제가 발생한 바이너리의 UUID와 대조할 수 있는 원본 dSYM이 확보됐는지는 별도로 점검해야 합니다.
App Store 배포에 올바른 심볼 파일이 포함됐는지 어떻게 확인하나요?
배포한 빌드의 식별 정보를 확인한 뒤, 크래시 보고서의 바이너리 UUID와 보유한 dSYM의 UUID가 일치하는지 대조하세요. App Store Connect의 빌드 표시만으로 로컬 파일의 일치 여부를 확정하지 마세요. 심볼 자료의 처리나 노출 상태를 확인할 수 있더라도, 팀이 해당 빌드의 Archive와 dSYM을 다시 찾아 쓸 수 있는지는 별개의 운영 문제입니다.
06 다음 배포부터 Archive와 심볼을 함께 보관합니다
오래된 빌드의 Archive가 이미 사라졌다면 복구를 보장할 수 없습니다. 다음 배포부터는 빌드와 심볼 자료를 하나의 추적 가능한 단위로 관리하세요. 아래 항목은 배포가 끝난 뒤에도 실제 파일을 찾아 대조할 수 있는지 확인하는 절차입니다.
- [ ] 배포에 사용한 Archive를 지정된 보관 위치에 저장합니다.
- [ ] 같은 Archive에서 주 앱, 확장, 프레임워크의 dSYM을 확인합니다.
- [ ] 빌드 식별 정보와 각 바이너리의 UUID를 기록합니다.
- [ ] 보관 위치와 파일을 찾는 방법을 팀 문서에 남깁니다.
- [ ] 다른 담당자나 환경에서 파일을 다시 찾아 UUID를 대조할 수 있는지 확인합니다.
- [ ] 배포를 완료한 뒤에도 Archive와 dSYM이 함께 남아 있는지 점검합니다.
원격 Mac을 빌드 환경으로 쓴다면 파일이 생성됐다는 사실에서 점검을 끝내지 마세요. 빌드가 끝난 뒤 Archive와 dSYM이 어디에 놓였는지, 담당자에게 어떤 방식으로 전달됐는지, 전달받은 쪽에서 다시 찾아 UUID를 확인할 수 있는지까지 검증해야 합니다. 이 글에서는 CALMVPS의 실제 빌드 설정이나 보관 기록을 확인할 수 있는 자료가 제공되지 않아 특정 구성이나 전달 방식을 단정하지 않습니다.
현재 쓰는 방식이 개인 컴퓨터에만 의존한다면 장비가 꺼져 있거나 저장 공간이 부족할 때 보관과 재확인이 어려울 수 있습니다. 반대로 원격 환경은 접근 권한, 산출물 전달, 보관 위치를 직접 확인해야 합니다. 장기간 같은 Mac에서 무거운 작업을 계속 실행하거나 물리 장치 연결이 필요한 경우에는 임대보다 직접 보유한 Mac이 적합할 수 있습니다. 다만 배포 후 심볼 자료를 확인할 임시 환경이나 지속 가능한 원격 빌드 환경이 필요하다면, CALMVPS 이용 요금과 한국 주문 안내에서 제공 조건을 확인한 뒤 Archive와 dSYM을 직접 저장하고 회수할 수 있는 흐름인지 판단하세요. 원격 Mac을 선택하더라도 자동 백업이나 고정 보관이 제공된다고 가정하지 말고, 실제 파일 보관과 전달 절차를 확인해야 합니다.