Swift 6.2 소유권 오류는 어떻게 고칠까? 기존 프로젝트 긴급 복구 가이드 (2026)

먼저 실제 Swift 컴파일러 버전과 언어 모드, 전체 진단을 확인한 뒤 값의 복사 가능 여부와 이후 사용 여부, API 계약에 맞춰 수정해야 합니다. 이 방법은 도구 체인을 올린 뒤 기존 iOS 프로젝트에서 borrowing, consuming, Copyable 관련 오류를 분류하고 회귀 범위를 통제하려는 팀에 적합합니다.
이 글은 Swift 업그레이드와 컴파일 회귀를 관리하는 기술 책임자를 위한 안내입니다.
소유권 진단을 받고 있는 개발자, 제네릭이나 공용 API 변경의 호환성을 따져야 하는 설계 담당자도 대상입니다.
Swift 6.2 소유권 오류와 도구 체인 오류 구분
오류가 새 컴파일러를 설치한 직후 나타났다고 해서 곧바로 소유권 문제가 원인인 것은 아닙니다. Xcode, Swift 컴파일러, 언어 모드, 대상별 빌드 설정이 서로 다르면 같은 저장소에서도 결과가 달라질 수 있습니다. 패키지 의존성이나 생성 코드가 특정 설정을 전제로 하는 경우도 있습니다.
먼저 실패하는 대상 하나를 고정하고 다음 내용을 기록합니다.
- Xcode와 실제 호출된 Swift 컴파일러의 버전
- 해당 대상의 Swift 언어 모드와 빌드 설정
- 오류 전문과 오류가 가리키는 선언, 호출 지점
- 실패 대상과 성공 대상으로 나뉘는 패키지 또는 모듈
Apple의 Xcode 26 릴리스 노트와 빌드 설정 참조를 확인해 도구 체인 정보와 대상별 설정을 대조합니다. 동시성 진단이 함께 표시된다면 이를 소유권 진단과 같은 오류로 뭉뚱그리지 말고, Swift 6 동시성 마이그레이션 안내의 데이터 경쟁 관련 설정과도 구분합니다.
장면을 하나 가정해 보겠습니다. 앱 본체에서는 빌드가 되지만 공용 프레임워크에서만 실패한다면, 전체 저장소에 일괄 수정부터 적용하지 않습니다. 해당 프레임워크의 설정과 실제 오류 위치를 먼저 확인해야 합니다. 타입 제약 오류, 의존성 오류, 소유권 진단은 서로 다른 원인일 수 있습니다.
값 소비 오류와 생명 주기 추적
값이 이미 소비됐거나 이후에 다시 사용됐다는 진단은 해당 값이 처음 전달된 곳부터 따라가야 합니다. 함수 호출, 조건 분기, 클로저 캡처 중 어디에서 소유권이 바뀌었는지 확인하고, 그 이후 코드가 같은 값을 필요로 하는지 판단합니다.
수정 방향은 타입과 의도에 따라 달라집니다.
- 함수가 소유권을 넘겨받아야 한다면 이후 호출부에서 해당 값을 다시 사용하지 않도록 흐름을 정리합니다.
- 호출자가 계속 값을 써야 한다면 함수가 빌리는 계약인지 검토합니다.
- 값의 타입이 복사를 허용하고 별도 값이 필요한 상황이라면 복사 가능성에 맞는 표현을 검토합니다.
Swift의 SE-0366 제안은 consume 연산을 다룹니다. 이를 모든 오류에 덧붙이는 해결책으로 보면 안 됩니다. 소유권 전달이 실제 의도인지 확인한 뒤 사용해야 합니다. 복사가 가능한 타입이라고 해서 복사가 항상 비용이나 동작 측면에서 무해하다는 뜻도 아닙니다.
borrowing과 consuming의 API 계약
두 매개변수 방식의 차이는 호출 뒤 누가 값의 생명 주기를 책임지는지에 있습니다. SE-0377은 매개변수의 borrowing과 consuming 소유권 표시를 설명합니다.
- 호출자가 함수 실행 뒤에도 값을 사용할 필요가 있고 함수가 소유권을 가져갈 이유가 없다면 borrowing 계약을 살펴봅니다.
- 함수가 값을 넘겨받아 이후 생명 주기를 맡아야 한다면 consuming 계약을 검토합니다.
- 함수가 값의 상태를 바꾸거나 저장하는 구조라면 두 선택지만 보지 말고 기존 타입과 API 설계를 함께 확인합니다.
공용 API의 매개변수 계약을 바꾸기 전에는 모든 호출부와 모듈 경계를 점검합니다. 외부에 공개된 프레임워크라면 소스 호환성과 배포 방식에 따른 ABI 호환성도 별도로 검토해야 합니다. 한 호출 지점의 오류를 없애기 위해 선언을 바꾸면 다른 모듈이나 고객 앱에서 새 오류가 생길 수 있습니다. Swift 컴파일러의 버전과 모드별 동작은 공식 컴파일러 문서에서 확인할 수 있습니다.
Copyable 충돌과 제네릭 제약의 층위
Copyable 오류는 호출 지점만 보면 원인을 놓치기 쉽습니다. 구체 타입의 선언에서 시작해 제네릭 매개변수, 프로토콜 요구 사항, 값을 담는 컨테이너 순으로 확인합니다. 제네릭 인터페이스가 복사 가능성을 요구하지만 실제 타입은 비복사형이라면 인터페이스에 필요한 제약이 표현되지 않았거나, 타입 설계와 사용 방식이 어긋난 것일 수 있습니다.
SE-0390은 비복사 구조체와 열거형의 설계를 다루며, SE-0427은 비복사 제네릭을 다룹니다. 제네릭 선언을 읽을 때는 Swift 언어 안내의 제네릭 설명도 함께 대조합니다. 표준 라이브러리의 관련 기반 요소는 SE-0437에서 확인할 수 있습니다.
따라서 기존 프로젝트 전체를 비복사형으로 바꾸는 것은 기본 해결책이 아닙니다. 복사를 허용하지 않아야 한다는 타입 의미가 분명할 때만 해당 설계를 검토합니다. 그 외에는 제네릭 요구 조건이나 호출부에서 값을 재사용하는 방식을 먼저 살핍니다.
대규모 빌드 실패의 범위 축소
한꺼번에 여러 모듈을 수정하면 어떤 변경이 어떤 오류를 해결했는지 추적하기 어렵습니다. 다음 순서로 범위를 좁히면 원인과 회귀를 함께 관리할 수 있습니다.
- 모듈별로 실패 대상을 분리하고 진단을 생명 주기, API 계약, Copyable 제약, 도구 체인 문제로 분류합니다.
- 각 분류에서 실제 호출 경로가 대표적인 대상을 하나 골라 최소 재현을 만듭니다.
- 공용 프레임워크, Swift 패키지, 생성 코드에 적용된 컴파일 설정을 비교합니다.
- 대표 경로에서 수정이 통과하면 같은 원인이 확인된 코드에만 변경을 확장합니다.
- 모듈별 빌드와 관련 테스트를 실행하고 변경 전후 동작을 비교합니다.
- 한 번에 하나의 의미 있는 단위로 변경을 제출해 문제가 생기면 되돌릴 지점을 남깁니다.
대상별 설정은 빌드 설정 참조를 기준으로 확인할 수 있습니다. 다만 설정이 같아 보인다는 이유만으로 의존성이나 생성 코드까지 검증됐다고 판단해서는 안 됩니다.
병합 전 변경 확인 목록
아래 항목을 확인한 뒤에만 수정 범위를 넓힙니다.
- [ ] 실패 대상을 동일한 컴파일러와 언어 모드에서 다시 빌드했습니다.
- [ ] 전체 진단을 보존하고 오류가 가리키는 선언과 호출 지점을 확인했습니다.
- [ ] 값이 처음 전달되거나 소비되는 위치와 이후 사용 경로를 확인했습니다.
- [ ] borrowing 또는 consuming 변경이 API 의도와 모든 호출부에 맞는지 점검했습니다.
- [ ] 제네릭과 프로토콜의 Copyable 요구가 실제 타입 설계와 일치하는지 확인했습니다.
- [ ] 공용 모듈, 패키지, 생성 코드의 설정을 따로 확인했습니다.
- [ ] 오류 경로와 클로저 캡처를 포함해 빌드와 관련 테스트를 실행했습니다.
- [ ] 변경을 모듈 단위로 나누고 실패 시 되돌릴 기준을 정했습니다.
기존 로컬 환경에서 도구 체인 설정을 통일하기 어렵거나, 실제 기기용 빌드를 재현할 별도 맥 환경이 필요한 경우에는 클라우드 맥을 검증 환경으로 고려할 수 있습니다. 다만 임시 환경이 Swift 타입 오류 자체를 고쳐 주지는 않습니다. 먼저 오류를 재현하고 원인을 좁혀야 합니다. Xcode 설정과 iOS 빌드 검증용 환경을 다룰 때는 ProxyMac의 콘솔 안내와 도움말를 참고하고, 현재 환경의 일관성이 문제라면 요금 정보를 확인할 수 있습니다. 현재 방식이 도구 체인 불일치, 공유 장비 대기, 깨끗한 빌드 환경 부족으로 반복해서 막힐 때는 맥 대여가 검증을 더 편리하게 만들 수 있습니다. 반대로 장기간 고정된 고부하 작업이나 물리 장비 연결이 중요하다면 직접 보유한 맥이 더 적합할 수 있습니다.