ViewBuilder 안의 #available
— 소스는 그대로인데 구형 OS에서만 죽는 크래시
안녕하세요. 물먹고하자입니다. 이번에 반나절 정도 제대로 헤맨 케이스가 있어서 정리해 둡니다.
사내 협업앱 iOS 프로젝트에서 "채팅방에 들어가면 앱이 죽는다"는 제보가 들어왔어요. 그런데 제 개발 기기(iOS 27)에선 멀쩡하고, 최신 시뮬레이터로 몇 번을 들어가도 안 죽더라고요. 리포트를 보니 iPhone XS / iOS 18.7 이었습니다. 그래서 같은 조건 시뮬레이터를 새로 만들어 띄웠더니 — 진입하자마자 바로 죽었습니다. 100% 재현이었어요.
더 당황스러운 건, 그 코드가 2024년부터 한 줄도 안 바뀌었다는 거였습니다. 😅
# 시뮬레이터 콘솔 (log show) — 크래시 직전 마지막 줄
(libswiftCore.dylib) Failed to look up symbolic reference at 0x1128cc2dc
- offset 6362148
- symbol symbolic _____yAAyAAyAAyAAyAAyAAyAAyAAy_____y_____y_____yACy…
# 그 뒤로 "해석에 성공한" 타입 목록이 쭉 이어짐
ModifiedContent ZStack TupleView VStack _ConditionalContent AnyView
ScrollViewReader IDView LazyVStack ForEach Rectangle Color Text Image …
밑줄 _____ 자리가 전부 해석에 실패한 symbolic reference입니다. 뒤에 붙는 목록엔 해석에 성공한 타입만 이름이 찍히고, 정작 실패한 놈은 안 나와요. 그래서 "이 파일이 참조하는 weak 심볼 중 타입 디스크립터는 뭐가 있나"를 역으로 뒤지는 소거법이 필요했습니다.
1. 스택이 전부 런타임 안쪽이라 막막했어요
swift::fatalError
← ResolveAsSymbolicReference::operator()(...) ← 여기서 abort
← Demangler::demangleSymbolicReference
← swift_getTypeByMangledName
← swift_getAssociatedTypeWitness
← BodyAccessor.makeBody(container:inputs:fields:)
← protocol witness for static View._makeView(...) in conformance MessageListView
EXC_CRASH (SIGABRT) 인데 우리 코드가 스택에 거의 없습니다. 전부 libswiftCore 예요.
그나마 단서는 크래시 스레드 레지스터에 fatalError 문자열이 그대로 실려 있다는 거였습니다. x10~x15를 리틀엔디안 ASCII로 읽으면 이렇게 나와요.
x10 0x6572656665722061 "a refere"
x11 0x61206f742065636e "nce to a"
x13 0x697373696d206120 " a missi"
x14 0x206b61657720676e "ng weak "
x15 0x000a6c6f626d7973 "symbol\n"
"reference to a missing weak symbol" — 런타임이 뷰의 타입 이름을 디망글하다가 weak로 링크된(= 구버전 OS엔 없는) 심볼을 만나 NULL을 받고 죽은 겁니다.
2. 범인 심볼을 nm으로 좁히기
어떤 심볼인지가 핵심인데, 이건 바이너리에서 기계적으로 뽑을 수 있어요. "최종 바이너리에서 weak로 확정된 심볼"과 "문제 파일이 참조하는 심볼"의 교집합을 봅니다.
# 1) 최종 바이너리의 weak import 중 SwiftUI 것만
nm -m MyApp.debug.dylib | grep "undefined.*weak external" \
| grep "from SwiftUI" | sed 's/.*weak external //;s/ (from SwiftUI)//' \
| sort -u > weak.txt
# 2) 문제 파일(.o)이 참조하는 undefined 심볼
nm -u MessageListView.o | sort -u > undef.txt
# 3) 교집합 → 디망글
comm -12 weak.txt undef.txt | sed 's/^_//' | xcrun swift-demangle
결과가 3개였는데 그중 타입 디스크립터는 딱 하나 — SwiftUI.TupleContent 였습니다. 크래시가 타입 디망글 중이었으니 소거법으로 확정이죠.
같은 방식으로 빌드 산출물 전체(오브젝트 941개 + SPM 패키지 전부)를 훑어서 이 심볼을 참조하는 파일이 앱 전체에 딱 2개인 것까지 뽑아냈습니다. 이게 나중에 "고칠 곳이 정확히 어디냐"에 그대로 답이 됐어요.
3. 안전장치가 "조건부"였다는 게 함정
TupleContent는 새 SDK에서 신설된 타입이고 @available(iOS 26.0, *) 입니다. 우리 코드는 그런 걸 쓴 적이 없는데 왜 들어갔을까요?
문제의 코드는 이런 평범한 모양이었습니다.
var body: some View {
ZStack {
VStack(spacing: 0) {
if #available(iOS 16.0, *) { // ← 범인
NewListView(...)
} else {
LegacyScrollView(...)
}
// ... 다른 형제 뷰들
}
}
}
if #available을 ViewBuilder 안에 쓰면, 원래는 buildLimitedAvailability가 그 블록 타입을 AnyView로 지워줍니다. 신버전 전용 타입이 바깥으로 새지 않게 막는 장치예요. 그런데 시그니처를 보면 조건이 붙어 있습니다.
static func buildLimitedAvailability<Content>(_ content: Content) -> AnyView
where Content : View // ★ 내용물이 View 여야만 지워준다
새 SDK에서 ViewBuilder.buildBlock이 가변 제네릭으로 바뀌면서, 이 블록이 만드는 타입이 TupleView → TupleContent 로 바뀌었어요. 그런데 TupleContent는 iOS 26 이상에서만 View 입니다. 그러니 where Content : View 제약이 깨지고 → 소거가 안 되고 → 신버전 전용 타입이 body 타입 메타데이터에 그대로 박힙니다.
안전 변경됨 위험
즉 소스가 아니라 툴체인을 올린 것이 트리거였습니다. diff가 0인데 터지는 회귀라, 코드 리뷰로는 절대 못 잡아요.
buildBlock을 타서 TupleContent가 안 만들어져요. 제가 최소 재현 코드를 만들면서 계속 실패했던 이유가 이겁니다.
바꿔 말하면 오늘은 멀쩡해도 나중에 형제 뷰 하나만 추가되면 그때 터지는 잠복 상태라는 뜻이에요.
4. 사실 컴파일러가 이미 말하고 있었습니다
한참 헤매다 빌드 경고를 다시 봤는데, 이게 있더군요.
warning: result builder 'ContentBuilder' (aka 'ViewBuilder') does not implement
'buildLimitedAvailability'; this code may crash on earlier versions of the OS
"may crash on earlier versions of the OS" — 애플이 대놓고 알려주고 있었어요. 그런데 프로젝트 경고가 531개라 그냥 묻혔습니다. 😇
경고 문구도 정확히는 "함수가 없다"가 아니라 "이 내용물에 맞는 오버로드가 없다"는 뜻이었습니다.
MessageListView.swift:106:20: warning: result builder 'ContentBuilder' (aka 'ViewBuilder')
does not implement 'buildLimitedAvailability';
this code may crash on earlier versions of the OS
MessageListView.swift:104:9: warning: conformance of 'TupleContent<repeat each Content>'
to 'View' is only available in iOS 26.0 or newer
MessageListView.swift:105:13: warning: (동일 경고)
106행이 if #available, 104·105행이 그걸 감싸는 ZStack/VStack 입니다. 범인과 공범을 컴파일러가 정확히 다 짚어주고 있었어요. 앱 전체로는 buildLimitedAvailability 경고 3건 · TupleContent 경고 19건이 떠 있었습니다.
5. 수정은 허무할 정도로 간단
앱 최소 지원 버전이 이미 iOS 18이었습니다. 그러니 #available(iOS 16.0, *)는 항상 참인 죽은 조건이었어요. 래퍼만 걷어내고 else 레거시 경로를 지우면 끝입니다.
var body: some View {
ZStack {
VStack(spacing: 0) {
NewListView(...) // #available 래퍼 제거, 그대로 승격
// ...
}
}
}
조건이 원래 항상 참이었으니 어느 OS에서도 동작이 안 바뀝니다. 검증은 시뮬레이터 없이도 되게 오라클을 잡아뒀어요.
nm -u MessageListView.o | grep -c TupleContent # 1 → 0 이면 성공
# ─────────── 수정 전 ───────────
$ nm -u MessageListView.o | grep -c TupleContent
1
$ nm -u PopoverInfoView.o | grep -c TupleContent
1
$ # 앱 전체 (모듈 92개 오브젝트 전수 스캔)
2 건
$ # 빌드 경고
buildLimitedAvailability : 3 TupleContent : 19
$ # 최종 바이너리 weak 심볼
nominal type descriptor for SwiftUI.TupleContent
# ─────────── 수정 후 ───────────
$ nm -u MessageListView.o | grep -c TupleContent
0
$ nm -u PopoverInfoView.o | grep -c TupleContent
0
$ # 앱 전체
0 건
$ # 빌드 경고
buildLimitedAvailability : 0 TupleContent : 0
$ # 최종 바이너리 weak 심볼
TupleContent 없음
6. 재발 방지 — 경고를 "에러"로 승격
같은 실수가 또 나오면 안 되니 가드를 걸었습니다. Swift 컴파일러가 경고에 진단 그룹 이름을 같이 찍어준다는 걸 이번에 처음 알았어요.
warning: ... does not implement 'buildLimitedAvailability'; ... [#ResultBuilderMethods]
^^^^^^^^^^^^^^^^^^^^^^
이 안이 그룹 이름
그리고 이 그룹 단위로 경고를 에러로 올릴 수 있습니다. 빌드 설정에 한 줄이면 끝이에요.
// Build Settings → Other Swift Flags
OTHER_SWIFT_FLAGS = "-Werror ResultBuilderMethods"
// 반대로 낮추고 싶으면
OTHER_SWIFT_FLAGS = "-Wwarning ResultBuilderMethods"
전역 SWIFT_TREAT_WARNINGS_AS_ERRORS 는 기존 경고가 수백 개라 못 씁니다. 그룹 단위라서 딱 이것만 막을 수 있는 게 핵심이에요.
마무리
솔직히 말하면 가설을 다섯 번 틀렸습니다. 자식 뷰 개수 때문인가, UIViewRepresentable 때문인가, Swift 언어 모드 때문인가, 배포 타깃이 오염됐나… 전부 아니었어요. 그러다 빌드 경고 한 줄이 정답을 그냥 알려줬습니다. 순서가 완전히 거꾸로였죠. 😅
교훈 두 가지만 남기자면,
- "재현 안 됨"은 "문제 없음"이 아니다. 신형 OS는 결함을 덮어줄 때가 있어서, 리포트에 적힌 기기·OS를 그대로 맞춰야 보입니다. 이번에도 iOS 27에선 100번을 들어가도 멀쩡했어요.
- 경고를 쌓아두면 진짜 경고가 묻힌다. "may crash"라고 적힌 경고가 531개 사이에 끼어 있었습니다. 그래서 이 패턴은 아예 CI에서 빌드를 깨도록 게이트를 걸기로 했어요. 심볼 이름으로 막는 것보다 경고로 막는 쪽이 낫습니다 — 미래 SDK가 또 다른 타입을 들고 와도 유효하고, 위에 적은 "자식 하나라 아직 안 터지는" 잠복 케이스까지 잡아주거든요.
Xcode 메이저 버전 올릴 때는 구형 OS 실기기 스모크 테스트를 꼭 넣으세요. 저처럼 반나절 태우지 마시고요 😊
댓글
댓글 쓰기