AI Development

2026 Swift 6.2 SwiftData: 동시성 데이터 계층은 어떻게 단계적으로 개조할까?

2026 Swift 6.2 SwiftData: 동시성 데이터 계층은 어떻게 단계적으로 개조할까?

SwiftData 저장 뒤 화면이 멈추고, @Sendable 진단과 액터 격리 오류가 한꺼번에 늘어났다면 전역 @MainActor부터 붙이지 않아야 합니다.

승자는 도구 모음과 재현 기준을 먼저 고정한 뒤, 가장 위험한 쓰기 호출 하나를 @ModelActor로 닫고 PersistentIdentifier 또는 전송 가능한 자료형으로 경계를 넘기는 방식입니다.

이 글은 Swift 6.2 분기에서 앱을 계속 유지해야 하는 개발자를 위한 안내서입니다.
데이터 접근 경계를 나눌 아키텍트와 회귀 범위를 통제할 기술 책임자에게도 맞습니다.
여러 프로젝트 분기를 따로 검증할 독립 맥 환경이 필요한 경우에도 적용할 수 있습니다.

먼저 바로잡을 전제: Swift 6.2와 Xcode 26의 관계

이 주제에서 가장 먼저 정리할 부분은 도구 모음입니다. 공식 자료에 따르면 Xcode 26 초기 버전에는 Swift 6.2가 포함됩니다. Xcode 26.6에는 Swift 6.3이 포함됩니다. 따라서 이 글은 최신 도구 모음으로 무조건 올리라는 글이 아니라, Swift 6.2를 고정한 유지 분기에서 데이터 계층을 개조하는 방법을 설명합니다. 버전 관계는 공식 Xcode 26 공개 자료에서 다시 확인해야 합니다.

공식 버전 순서에 Xcode 18이 있다는 전제로 작업해서는 안 됩니다. 또한 Swift 6 언어 모드와 기본 액터 격리는 모든 오래된 프로젝트에 자동으로 강제되는 설정이 아닙니다. 타깃별 언어 모드와 동시성 검사 수준을 확인해야 합니다. 기본 액터 격리를 다루는 설계 근거는 기본 액터 격리 제안서에서 확인할 수 있습니다.

실패 사례: 전체에 @MainActor를 붙인 뒤

오래된 프로젝트에서 컴파일 오류를 빨리 줄이려고 저장소, 서비스, 화면 상태에 전부 @MainActor를 붙이는 경우가 있습니다. 진단 수는 줄어들 수 있습니다. 그러나 백그라운드 가져오기와 저장까지 주 액터로 몰리면 화면 입력과 저장 작업이 같은 실행 경로에서 기다리게 됩니다.

이때 화면이 멈췄다고 해서 곧바로 데이터베이스 교착이라고 부르면 안 됩니다. 다음 네 가지를 분리해야 합니다.

  • 컴파일 진단: 전송 가능한 자료형이 아닌 값이 경계를 넘는 문제입니다.
  • 실행 중 격리 실패: 허용되지 않은 액터에서 모델이나 문맥에 접근한 문제입니다.
  • 주 액터 차단: 오래 걸리는 조회나 저장이 화면 실행 경로를 점유한 문제입니다.
  • 실제 교착: 스레드 샘플과 호출 스택에서 서로 진행을 기다리는 증거가 확인된 경우입니다.

@ModelActor가 모델 속성에 대한 상호 배타적 접근을 제공한다고 해서 모든 멈춤이 저장소 내부 잠금이나 데이터베이스 교착은 아닙니다. 공개된 문법과 의미는 ModelActor 공식 문서 범위에서만 단정해야 합니다.

첫 한 시간: 한 줄의 호출 경로만 고정합니다

처음부터 데이터 계층 전체를 그리지 않습니다. 새 항목 저장, 기존 항목 갱신, 대량 가져오기 중 하나를 고릅니다. 장애가 자주 보이는 쓰기 경로가 우선입니다.

다음 자료를 별도 파일로 보존합니다.

  1. 문제가 다시 나타나는 최소 테스트입니다.
  2. 컴파일 진단 원문과 실행 로그입니다.
  3. 멈춘 시점의 호출 스택입니다.
  4. 주 액터와 백그라운드 작업의 스레드 샘플입니다.
  5. 개조 전 분기 또는 이전 구현으로 돌아갈 수 있는 지점입니다.

그 다음 ModelContainer, ModelContext, 화면 상태, 백그라운드 작업의 소유자를 한 줄씩 기록합니다. 특히 다음 전달을 표시합니다.

  • @Model 인스턴스를 클로저 안에 넣는가
  • 한 문맥에서 읽은 모델을 다른 액터로 보내는가
  • ModelContext 자체를 서비스 속성으로 공유하는가
  • 취소된 작업이 저장을 계속하는가
  • 화면이 백그라운드 문맥의 소유권을 다시 가져가려 하는가

이 단계의 완료 증거는 “오류가 사라졌다”가 아닙니다. 어떤 값이 어느 경계를 넘는지 설명할 수 있고, 같은 테스트와 같은 로그를 다시 얻을 수 있어야 합니다.

첫 커밋: 전체 서비스 대신 한 개의 모델 액터

첫 커밋의 목표는 예쁜 공통 저장소가 아닙니다. 선택한 쓰기 호출의 문맥을 한 곳에 닫는 것입니다. 호출자는 필요한 값만 넘기고, 조회와 수정과 저장은 모델 액터 내부에서 끝냅니다.

@ModelActor
actor ImportStore {
    func insert(title: String, source: String) throws -> PersistentIdentifier {
        let item = Note(title: title, source: source)
        modelContext.insert(item)
        try modelContext.save()
        return item.persistentModelID
    }
}

위 예시는 구조를 보여 주는 최소 형태입니다. 모든 프로젝트에 그대로 맞는 만능 템플릿은 아닙니다. 모델 생성자와 반환값은 프로젝트 계약에 맞춰 조정해야 합니다.

의존성은 호출부에서 주입합니다.

struct ImportService {
    let store: ImportStore

    func run(title: String, source: String) async throws -> PersistentIdentifier {
        try await store.insert(title: title, source: source)
    }
}

핵심은 세 가지입니다.

  • 호출부가 다른 문맥의 모델을 넘기지 않습니다.
  • 액터가 자기 문맥에서 생성하고 저장합니다.
  • 반환값은 모델 객체가 아니라 식별자나 전송 가능한 값입니다.

ModelContext는 저장과 조회를 수행하는 경계 안에 둬야 합니다. 문맥을 전역 싱글턴으로 만들거나 여러 액터가 동시에 재사용하는 방식은 단순한 경계 개조가 아닙니다. 이때는 소유권 설계부터 다시 해야 합니다. 문맥의 공개 의미는 ModelContext 공식 자료를 기준으로 확인합니다.

모델 객체 대신 무엇을 돌려줘야 할까요?

@ModelActor가 모델 객체를 반환하면 화면이나 다른 액터가 그 객체를 계속 사용할 가능성이 커집니다. 그러면 모델의 소유 문맥과 사용 위치가 다시 섞입니다. 기본 반환값은 다음 우선순위가 안전합니다.

  1. 생성 또는 갱신된 객체의 PersistentIdentifier
  2. 화면에 표시할 문자열, 날짜, 상태를 담은 불변 자료형
  3. 명시적으로 Sendable을 만족하는 자료 전송 객체
  4. 정말 필요한 경우에만 액터 내부에서 만든 읽기 전용 결과

PersistentIdentifier는 객체 자체가 아닙니다. 받는 쪽은 자기 문맥에서 식별자로 다시 가져와야 합니다. 식별자의 공개 의미는 PersistentIdentifier 공식 문서에서 확인합니다.

struct NoteSummary: Sendable {
    let id: PersistentIdentifier
    let title: String
}

@ModelActor
actor NoteStore {
    func summary(for id: PersistentIdentifier) throws -> NoteSummary? {
        let descriptor = FetchDescriptor<Note>()
        let notes = try modelContext.fetch(descriptor)

        guard let note = notes.first(where: { $0.persistentModelID == id }) else {
            return nil
        }

        return NoteSummary(id: note.persistentModelID, title: note.title)
    }
}

실제 조회 조건은 식별자와 프로젝트 모델에 맞춰 작성해야 합니다. 중요한 점은 화면에 백그라운드 문맥의 모델을 보내지 않는 것입니다.

주의: 세마포어, 동기 대기, 동기 큐로 주 액터에 되돌아오는 방식은 격리 경계를 고친 것이 아닙니다. 취소와 오류가 작업 생명주기 밖으로 빠져나가면 멈춤이 재현되기 더 어려워집니다.

당일 작업: 입력과 출력 계약을 바꿉니다

첫 커밋이 컴파일 경계를 만들었다면, 같은 날에는 호출 계약을 바꿔야 합니다. 기존 함수가 모델 객체를 인자로 받는다면 식별자나 값 자료형으로 변경합니다.

나쁜 계약은 다음과 같습니다.

func update(_ item: Note) async throws

이 함수는 누가 만든 Note인지, 어느 문맥이 관리하는지 알 수 없습니다. 다음처럼 바꿉니다.

struct NoteChange: Sendable {
    let id: PersistentIdentifier
    let title: String
}

func update(_ change: NoteChange) async throws

액터 내부에서 식별자로 객체를 다시 얻고, 변경과 저장을 같은 경계에서 실행합니다. 화면은 저장 결과를 기다린 뒤 표시용 자료만 갱신합니다. 백그라운드 문맥을 UI 상태에 넣지 않습니다.

오류와 취소도 구조화된 작업 안에서 처리합니다.

func save(_ change: NoteChange) async throws {
    try Task.checkCancellation()
    try updateInOwnedContext(change)
}

작업을 분리해야 한다면 호출자가 작업의 생명주기를 보유해야 합니다. 화면이 사라진 뒤에도 실행되는 생명주기 없는 Task를 빠른 해결책으로 만들지 않아야 합니다.

어떤 호출부터 옮길까요?

모든 호출을 같은 날 옮기면 회귀 범위를 알 수 없습니다. 첫 주에는 쓰기 빈도와 장애 영향으로 순서를 정합니다. 대량 가져오기처럼 오래 실행되고 실패 영향이 큰 경로가 첫 후보가 될 수 있습니다. 단순 화면 조회는 그 다음으로 미뤄도 됩니다.

호출 하나를 옮길 때마다 다음을 남깁니다.

  • 입력 계약이 모델 객체에서 값 자료형으로 바뀌었는가
  • 반환 계약이 모델 객체에서 식별자나 전송 객체로 바뀌었는가
  • 저장 문맥이 액터 내부에 남아 있는가
  • 취소와 오류가 호출자까지 전달되는가
  • 이전 구현으로 전환할 수 있는가

임시 표식을 정리하는 순서

@unchecked Sendable, @preconcurrency, Task.detached, 과도한 @MainActor는 모두 범위를 기록해야 합니다.

  • @unchecked Sendable: 실제 내부 상태 보호가 확인된 경우에만 제한적으로 둡니다.
  • @preconcurrency: 아직 바꾸지 못한 외부 모듈 경계에만 둡니다.
  • Task.detached: 상속할 실행 문맥이 없어야 하는 이유가 있을 때만 검토합니다.
  • 확대된 @MainActor: 화면 상태처럼 실제 주 액터 소유가 필요한 부분으로 좁힙니다.

외부 의존성이 아직 맞지 않으면 호환 계층을 모듈 가장자리에 둡니다. 업무 모델과 저장 액터까지 우회 표식을 퍼뜨리면 나중에 삭제할 위치를 잃습니다. 비동기 함수의 격리 규칙은 비동기 함수 격리 제안서를 참고할 수 있습니다.

첫 경로가 통과한 뒤에만 범위를 넓힙니다

발행 전에는 고정된 자료 세트로 다음 경로를 반복합니다.

  • 연속 저장
  • 작업 취소
  • 화면 전환과 백그라운드 복귀
  • 여러 창에서 같은 자료 접근
  • 확장 기능이 동시에 읽고 쓰는 상황
  • 실패 뒤 재시도
  • 저장 직후 화면 갱신

각 환경에서 컴파일 진단, 실행 중 오류, 주 액터 차단, 실제 교착을 따로 기록합니다. 시뮬레이터 상태나 파생 자료 폴더가 원인인지도 분리해야 합니다. 현재 배포 도구 모음과 계획 중인 도구 모음에서 같은 최소 프로젝트를 다시 빌드합니다.

아래 세 표는 이 시간축을 실제 결정으로 바꾸는 도구입니다.

선택지 적합한 조건 경계를 바꾸는 방식 완료 증거
한 개 쓰기 호출만 개조 오래된 프로젝트이고 회귀 범위를 작게 유지해야 함 호출 입력을 값 자료형으로 변경하고 모델 액터 내부에서 저장 최소 테스트와 이전 구현 전환이 모두 가능함
한 개 데이터 모듈 개조 모듈 소유자가 분명하고 호출자가 제한적임 모듈 밖에는 식별자와 전송 객체만 공개 모듈 경계 밖에서 문맥과 모델 전달이 사라짐
전체 데이터 계층 개조 소유권과 테스트가 이미 정리됨 모든 저장 경로를 같은 규칙으로 변경 여러 환경의 회귀 결과가 동일하게 설명됨
판단 지점 유지할 선택 피해야 할 선택
반환값 PersistentIdentifier, 불변 자료형, Sendable 자료 전송 객체 다른 문맥에서 관리하는 @Model 객체
저장 위치 모델 액터가 소유한 문맥 전역 문맥, 화면이 보유한 백그라운드 문맥
오류 처리 호출자가 기다리는 구조화된 비동기 작업 생명주기 없는 작업과 동기 대기
임시 우회 외부 모듈 가장자리의 제한된 호환 계층 업무 모델 전체에 퍼진 @unchecked Sendable
단계 바꿀 수 있는 범위 롤백 조건 보존할 자료
기준 고정 설정, 최소 테스트, 로그 재현 기준을 다시 만들 수 없음 이전 분기와 진단 원문
첫 경계 한 개 쓰기 호출 저장 결과나 취소 동작이 달라짐 이전 호출 입구
계약 변경 입력과 출력 자료형 화면 갱신 자료가 누락됨 이전 변환 코드
호출자 이동 한 개 호출 경로 다른 모듈에서 격리 오류가 증가함 기능 플래그 또는 전환 입구
확대 적용 검증된 규칙의 다른 모듈 다중 환경 결과가 일치하지 않음 모듈별 회귀 기록

독립된 맥 환경을 언제 붙일까요?

첫 번째 모델 액터 경로가 만들어진 뒤에는 독립된 맥 환경에서 이전 분기와 개조 분기를 나눠 검증하는 편이 좋습니다. 한 개발 기기의 파생 자료, 시뮬레이터 상태, 설치된 도구 모음에 결과가 묶이지 않기 때문입니다.

ProxyMac의 콘솔 환경과 도움말 안내를 확인할 때도 먼저 필요한 Xcode와 Swift 도구 모음의 설치 가능 여부, 프로젝트 전달 방식, 테스트 자료 보안 조건을 확인해야 합니다. 환경을 빌리는 목적은 성능을 과장하는 것이 아니라 같은 프로젝트를 분리된 조건에서 다시 빌드하고 실행하는 데 있습니다.

장기간 같은 무거운 작업을 계속 수행하거나 물리 포트, 특정 장치 연결, 고정된 로컬 저장소가 필요하다면 맥을 직접 구매하는 편이 맞을 수 있습니다. 반대로 Swift 6.2 분기와 다음 도구 모음을 나눠 확인해야 하거나, 개조 전후의 회귀 환경을 잠시 추가해야 한다면 임시 맥 환경이 더 합리적일 수 있습니다. 사용 기간과 필요한 도구 모음이 정해진 뒤에는 맥 환경 요금 안내에서 실제 제공 조건을 확인해야 합니다.

기존 개발 기기만 계속 쓰면 파생 자료가 남고, 한 도구 모음만 설치되며, 다른 분기를 동시에 비교하기 어렵습니다. 새 맥을 사면 장기 통제력은 높지만 짧은 검증을 위해 장비 비용과 관리 부담을 떠안게 됩니다. 그래서 첫 @ModelActor 경로처럼 범위가 정해진 검증에는 ProxyMac으로 독립 환경을 임시 확보하는 편이 작업 목적에 더 잘 맞을 수 있습니다. 단, 도구 모음 제공 여부와 프로젝트 조건을 확인한 뒤 선택해야 합니다.

단계적인 데이터 계층 개조를 ProxyMac과 함께 시작하세요

ProxyMac의 원격 맥 환경에서 동시성 데이터 계층 변경과 쓰기 흐름을 안전하게 점검할 수 있습니다.
식별자와 전송 가능한 자료형을 활용한 경계를 여러 개발 환경에서 반복 검증해 보세요.