iOS 17中@Bindable结合协议使用时的初始化错误问题

问题背景 #

iOS 17之前，我习惯用泛型+ObservableObject协议构建SwiftUI视图，既能方便测试，又能把UI相关逻辑封装到视图模型接口里：

@MainActor
protocol CityQueryViewModelInterface: ObservableObject {
    var text: String { get set }
    func fetchWeather() async throws -> WeatherItem
}

struct CityQueryView<ViewModel: CityQueryViewModelInterface>: View {    
    @ObservedObject var viewModel: ViewModel
}

但迁移到iOS 17的Observable宏后，尝试让协议继承Observable并在视图中使用@Bindable时，出现了报错：

protocol CityQueryViewModelInterface: Observable {
    var text: String { get set }
    func fetchWeather() async throws -> WeatherItem
}

@Observable
final class CityQueryViewModel: CityQueryViewModelInterface {
    // 实现内容
}

struct CityQueryView<ViewModel: CityQueryViewModelInterface>: View {
    @Bindable var viewModel: ViewModel // 报错：'init(wrappedValue:)' is unavailable: The wrapped value must be an object that conforms to Observable
}

报错原因 #

Observable宏会为具体类生成专属的Observable实现，当协议继承Observable时，编译器无法在编译期确认泛型参数ViewModel（仅遵循协议）确实是被@Observable宏处理过的类型——毕竟协议可以被任何非@Observable的类型实现，因此@Bindable的初始化条件不满足。

解决方案 #

方案1：协议继承ObservableObject（兼容迁移场景） #

利用@Observable宏会自动让类符合ObservableObject的特性，把协议改回继承ObservableObject，视图中仍可正常使用@Bindable：

@MainActor
protocol CityQueryViewModelInterface: ObservableObject {
    var text: String { get set }
    func fetchWeather() async throws -> WeatherItem
}

@Observable
final class CityQueryViewModel: CityQueryViewModelInterface {
    var text: String = ""
    
    func fetchWeather() async throws -> WeatherItem {
        // 业务逻辑实现
    }
}

struct CityQueryView<ViewModel: CityQueryViewModelInterface>: View {
    @Bindable var viewModel: ViewModel
    
    var body: some View {
        TextField("输入城市", text: $viewModel.text)
        Button("获取天气") {
            Task {
                try await viewModel.fetchWeather()
            }
        }
    }
}

这种方案几乎不需要修改原有协议结构，适合从ObservableObject迁移到Observable宏的项目。

方案2：分离协议与Observable约束（贴合新特性） #

让协议仅定义业务接口，将Observable作为泛型的额外约束，明确告诉编译器ViewModel是被@Observable处理过的类型：

@MainActor
protocol CityQueryViewModelInterface {
    var text: String { get set }
    func fetchWeather() async throws -> WeatherItem
}

@Observable
final class CityQueryViewModel: CityQueryViewModelInterface {
    var text: String = ""
    
    func fetchWeather() async throws -> WeatherItem {
        // 业务逻辑实现
    }
}

struct CityQueryView<ViewModel: CityQueryViewModelInterface & Observable>: View {
    @Bindable var viewModel: ViewModel
    
    var body: some View {
        // 视图内容
    }
}

这种方案更清晰地分离了业务接口和可观察特性，符合Observable宏的设计思路。

内容的提问来源于stack exchange，提问作者OldTimes