@StateObject: 개요, ObservableObject 생성 및 관리

SwiftUI에서 @StateObject란

@StateObject는 iOS 14에서 도입된 property wrapper로, View가 ObservableObject 프로토콜을 준수하는 클래스의 인스턴스를 생성하고 소유할 수 있게 합니다. 값 유형(struct)으로 작동하는 @State와 달리, @StateObject는 참조 유형 — 속성 변경 사항을 SwiftUI에 알릴 수 있는 클래스 — 을 위해 설계되었습니다.

View가 @StateObject var viewModel: MyViewModel을 사용하면 SwiftUI는 View가 처음 표시될 때 MyViewModel의 인스턴스를 자동으로 생성하고 프레임워크의 특별한 저장소에 보관합니다. View가 업데이트될 때마다(예: 부모 상태가 변경될 때) SwiftUI는 객체를 다시 생성하지 않고 View가 계층 구조에서 제거될 때까지 기존 인스턴스를 사용합니다.

Apple WWDC Session 10137(2024)에 따르면, @StateObject는 iOS 13에서 View가 재구축될 때 존재했던 데이터 손실 문제를 해결합니다. 이전에는 개발자가 부모 View에서 ObservableObject를 생성하고 초기화자를 통해 전달해야 했으며, 이로 인해 코드 중복과 실수로 객체가 다시 생성될 위험이 있었습니다.

import SwiftUI

class CounterViewModel: ObservableObject {
    @Published var count: Int = 0
    
    func increment() {
        count += 1
    }
}

struct CounterView: View {
    @StateObject var viewModel = CounterViewModel()
    
    var body: some View {
        VStack {
            Text("Count: \(viewModel.count)")
            Button("Increment", action: viewModel.increment)
        }
    }
}

@StateObject의 작동 방식

@StateObject 메커니즘은 SwiftUI와 Combine 프레임워크의 통합에 기반합니다. ObservableObject가 속성을 @Published 속성으로 표시하면 SwiftUI는 ObservableObject 프로토콜에 내장된 퍼블리셔를 통해 변경 사항을 자동으로 구독합니다. 게시된 속성이 변경되면 객체는 objectWillChange 퍼블리셔를 통해 신호를 보내고, 이 객체를 관찰하는 모든 View의 다시 그리기를 트리거합니다.

SwiftUI는 ObservableObject 인스턴스를 특정 View 인스턴스에 연결된 특별한 저장소에 보관합니다. 이 저장소는 첫 번째 렌더링 시 한 번 생성되며 View가 소멸될 때까지 존재합니다. 이것이 @StateObject가 참조 안정성을 보장하는 이유입니다 — SwiftUI는 View의 초기화자에 의존하지 않고 메모리를 자동으로 관리합니다.

objc.io — Thinking in SwiftUI(2025)에 따르면, @StateObject의 내부 구현은 @State와 유사한 메커니즘을 사용하지만 참조 유형용입니다. SwiftUI는 객체 주위에 박싱 래퍼를 만들고 빈번한 View 계층 구조 재구축에 최적화된 자체 할당자를 통해 수명 주기를 관리합니다.

@StateObject 수명 주기

• 생성 — View가 처음 화면에 나타날 때 SwiftUI는 객체의 초기화자를 호출하고 참조를 저장합니다.
• 재구축 — 부모 View가 업데이트될 때 객체는 다시 생성되지 않으며 기존 인스턴스가 사용됩니다.
• 소멸 — View가 화면을 떠나 계층 구조에서 제거될 때 SwiftUI는 객체의 deinit을 호출합니다.

@StateObject vs @ObservedObject: 주요 차이점

@StateObject와 @ObservedObject의 주요 차이점은 누가 객체를 소유하는지에 있습니다. @StateObject는 객체를 생성하고 저장합니다 — 그것이 소유자입니다. @ObservedObject는 다른 곳에서 생성되어 초기화자나 속성을 통해 전달된 객체를 관찰만 합니다.

규칙은 간단합니다. View가 ObservableObject를 생성하는 경우 @StateObject를 사용합니다. View가 부모로부터 이미 생성된 객체를 받기만 하는 경우 @ObservedObject를 사용합니다. 이 규칙을 위반하면 데이터 손실(소유권에 @ObservedObject 사용) 또는 과도한 객체 생성(관찰에 @StateObject 사용)이 발생합니다.

@StateObject 사용 시기

@StateObject는 특정 데이터 집합의 정보 소스 역할을 하는 View에서 사용해야 합니다. 일반적인 시나리오에는 자체 view model이 있는 화면, 네비게이션 스택의 루트 화면 및 자체 상태를 관리하는 모달 프레젠테이션이 포함됩니다.

• View model이 있는 화면 — 자체 데이터와 로직을 관리하는 각 화면은 @StateObject를 통해 view model을 생성해야 합니다.
• 루트 View — NavigationStack 또는 TabView 계층 구조에서 루트 요소가 데이터를 생성하고 자식 요소는 @ObservedObject를 통해 데이터를 받습니다.
• 모달 창 — .sheet 및 .fullScreenCover는 종종 폼이나 프로세스를 관리하기 위해 자체 @StateObject가 필요합니다.
• 편집 가능한 목록 — 편집 폼이 포함된 각 목록 행은 자체 @StateObject를 가져야 합니다.

struct ProfileView: View {
    @StateObject var viewModel = ProfileViewModel()
    
    var body: some View {
        NavigationStack {
            Form {
                TextField("Name", text: $viewModel.name)
                TextField("Email", text: $viewModel.email)
                Button("Save") {
                    viewModel.saveProfile()
                }
            }
            .navigationTitle("Profile")
        }
    }
}

매개변수로 @StateObject 초기화

@StateObject를 매개변수로 초기화하려면 특별한 구문이 필요합니다. SwiftUI가 객체 생성을 자체적으로 관리하기 때문입니다. 초기화자에 단순히 매개변수를 전달할 수 없습니다 — 이스케이핑 클로저나 별도의 팩토리 메서드를 사용해야 합니다.

Swift by Sundell(2024)에 따르면, 가장 깔끔한 방법은 SwiftUI가 객체를 처음 생성할 때 호출할 팩토리 메서드 또는 클로저를 사용하는 것입니다. 대안적인 접근 방식은 부모 View에서 ObservableObject를 초기화하고 표준 초기화자를 사용하여 @StateObject를 통해 전달하는 것입니다.

class UserViewModel: ObservableObject {
    @Published var user: User
    
    init(user: User) {
        self.user = user
    }
}

struct UserDetailView: View {
    @StateObject var viewModel: UserViewModel
    
    init(user: User) {
        _viewModel = StateObject(wrappedValue: UserViewModel(user: user))
    }
    
    var body: some View {
        Text(viewModel.user.name)
    }
}

@StateObject가 있는 View 초기화자는 property wrapper 자체에 접근하기 위해 속성 이름 앞에 밑줄(_viewModel)을 사용해야 합니다. 이는 초기화자에서 property wrapper로 작업하기 위한 표준 Swift 패턴입니다.

@StateObject 관련 일반적인 실수

가장 흔한 실수는 객체를 소유해야 하는 View에서 @StateObject 대신 @ObservedObject를 사용하는 것입니다. 이 경우 부모가 재구축될 때마다 객체가 다시 생성되어 축적된 모든 데이터가 손실됩니다. 이 실수는 NavigationStack 또는 TabView가 있는 복잡한 계층 구조에서 특히 교묘합니다.

• 네비게이션 중 데이터 손실 — 자식 화면이 자체 view model에 @ObservedObject를 사용하는 경우 뒤로 이동했다가 다시 열면 데이터가 재설정됩니다.
• 메모리 누수 — 제거되지 않는 부모 View에서 @StateObject를 생성하면 각 자식 화면도 제어 없이 @StateObject를 생성하는 경우 객체가 축적될 수 있습니다.
• 객체 중복 — 단일 ObservableObject를 여러 View의 여러 @StateObject에 전달하면 서로 동기화되지 않는 여러 독립 인스턴스가 생성됩니다.

이러한 문제를 피하려면 간단한 규칙을 따르세요. 정보 소스당 하나의 @StateObject. 데이터를 여러 화면에서 공유해야 하는 경우 루트 View에서 @StateObject를 한 번 생성하고 @ObservedObject 또는 @EnvironmentObject를 통해 자식 요소에 전달합니다.

// ❌ Wrong: @ObservedObject for owning an object
struct BadView: View {
    @ObservedObject var vm = ViewModel() // will be recreated on each update!
}

// ✅ Correct: @StateObject for owning
struct GoodView: View {
    @StateObject var vm = ViewModel() // created once for View lifetime
}