[iOS] ViewBuilder 안의 #available— 소스는 그대로인데 구형 OS에서만 죽는 크래시

[Swift] ViewBuilder 안의 #available

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 타입 메타데이터에 그대로 박힙니다.

구 SDK
새 SDK
블록이 만드는 타입
TupleView
TupleContent
무조건 View 인가
✅ 예
❌ iOS 26+ 에서만
AnyView 로 소거되나
✅ 소거됨
❌ 누출

안전   변경됨   위험

즉 소스가 아니라 툴체인을 올린 것이 트리거였습니다. 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 이면 성공
결과
오라클 0, 빌드 경고 0, 최종 바이너리의 weak 심볼도 사라짐. 그리고 iOS 18 시뮬레이터에서 대화방 진입까지 정상 확인했습니다.
# ─────────── 수정 전 ───────────
$ 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 언어 모드 때문인가, 배포 타깃이 오염됐나… 전부 아니었어요. 그러다 빌드 경고 한 줄이 정답을 그냥 알려줬습니다. 순서가 완전히 거꾸로였죠. 😅

교훈 두 가지만 남기자면,

  1. "재현 안 됨"은 "문제 없음"이 아니다. 신형 OS는 결함을 덮어줄 때가 있어서, 리포트에 적힌 기기·OS를 그대로 맞춰야 보입니다. 이번에도 iOS 27에선 100번을 들어가도 멀쩡했어요.
  2. 경고를 쌓아두면 진짜 경고가 묻힌다. "may crash"라고 적힌 경고가 531개 사이에 끼어 있었습니다. 그래서 이 패턴은 아예 CI에서 빌드를 깨도록 게이트를 걸기로 했어요. 심볼 이름으로 막는 것보다 경고로 막는 쪽이 낫습니다 — 미래 SDK가 또 다른 타입을 들고 와도 유효하고, 위에 적은 "자식 하나라 아직 안 터지는" 잠복 케이스까지 잡아주거든요.

Xcode 메이저 버전 올릴 때는 구형 OS 실기기 스모크 테스트를 꼭 넣으세요. 저처럼 반나절 태우지 마시고요 😊

댓글