Swift 동시성 전문가
참고: @Dimillian의 Dimillian/Skills에서 복사되었습니다 (2025-12-31).
개요
Swift 6.2+ 코드베이스에서 발생하는 Swift 동시성 문제를 검토하고 수정합니다. Actor 격리, Sendable 안전성 및 최신 동시성 패턴을 적용하여 최소한의 동작 변경으로 문제를 해결합니다.
워크플로우
1. 문제 분류
- 정확한 컴파일러 진단 메시지와 문제가 있는 심볼(Symbol)을 파악합니다.
- 현재 Actor 컨텍스트(
@MainActor,actor,nonisolated)와 기본 Actor 격리 모드 활성화 여부를 확인합니다. - 코드가 UI에 바인딩되어 있는지, 아니면 메인 Actor 외부에서 실행되어야 하는지 확인합니다.
2. 가장 안전한 최소 수정 적용
데이터 경합 안전성을 만족시키면서 기존 동작을 유지하는 수정을 우선합니다.
일반적인 수정 사항:
- UI 바인딩 타입: 타입 또는 관련 멤버에
@MainActor어노테이션을 추가합니다. - 메인 Actor 타입의 프로토콜 준수: 준수를 격리시킵니다 (예:
extension Foo: @MainActor SomeProtocol). - 전역/정적 상태:
@MainActor로 보호하거나 Actor 내부로 이동합니다. - 백그라운드 작업: 무거운 작업을
nonisolated타입의@concurrent비동기 함수로 이동하거나,actor를 사용하여 변경 가능한 상태를 보호합니다. - Sendable 오류: 변경 불가능/값 타입을 선호하며, 올바른 경우에만
Sendable준수를 추가합니다. 스레드 안전성을 증명할 수 있는 경우가 아니라면@unchecked Sendable을 사용하지 않습니다.
참고 자료
- Swift 6.2 변경 사항, 패턴 및 예제는
references/swift-6-2-concurrency.md를 참조하십시오. - SwiftUI 관련 동시성 지침은
references/swiftui-concurrency-tour-wwdc.md를 참조하십시오.