Swift 4泛型类动态变量添加Observer编译错误的解决办法

这个问题我之前踩过一模一样的坑，核心原因确实和泛型类型的Obj-C兼容性直接相关——你用了@objc dynamic修饰泛型类类型的属性，但Obj-C运行时完全不支持泛型，当Swift尝试把泛型类型的KeyPath转换成Obj-C能识别的格式时，就会出现Could not extract a String from KeyPath的致命错误。

下面给你几个可行的解决方案，你可以根据自己的业务场景选择：

方案1：改用Swift原生KVO（去掉@objc） #

如果你的代码不需要和Obj-C交互，完全可以抛弃Obj-C依赖，用Swift 4+引入的原生KVO。只需要保留dynamic关键字（Swift原生KVO要求属性是dynamic），去掉@objc即可：

// 去掉@objc，仅保留dynamic
dynamic var notifierData: NotifierData<ModelTypeStruct>

// 正常添加观察者
observer = observe(\.notifierData, options: [.old, .new]) { [weak self] object, change in
    guard let self = self else { return }
    // 处理notifierData的变化逻辑
    if let newData = change.newValue {
        // do something with newData
    }
}

注意：你的类必须继承自NSObject，Swift原生KVO只支持NSObject子类的dynamic属性。

方案2：用类型擦除兼容Obj-C（必须保留@objc时） #

如果你的属性必须暴露给Obj-C代码使用，就得做泛型类型擦除：创建一个非泛型的@objc兼容基类，让你的泛型NotifierData继承它，然后把属性声明为基类类型：

// 第一步：定义非泛型的Obj-C兼容基类
@objc class BaseNotifierData: NSObject {
    // 可以添加一些非泛型的通用方法/属性，供Obj-C调用
}

// 第二步：让泛型类继承基类
class NotifierData<ModelType>: BaseNotifierData {
    var model: ModelType?
    // 你的泛型类原有逻辑
}

// 第三步：属性声明为基类类型，标记@objc dynamic
@objc dynamic var notifierData: BaseNotifierData = NotifierData<ModelTypeStruct>()

// 添加观察者后，在回调中做类型转换
observer = observe(\.notifierData, options: [.old, .new]) { [weak self] object, change in
    guard let self = self else { return }
    if let newNotifierData = change.newValue as? NotifierData<ModelTypeStruct> {
        // 处理泛型类型的逻辑
    }
}

这种方式既满足了Obj-C的兼容性，又能在Swift代码中正常使用泛型功能。

方案3：SwiftUI场景下改用@Observable宏（推荐） #

如果你的代码是SwiftUI环境，且系统版本在iOS 17+/macOS 14+以上，完全可以抛弃KVO，改用Swift官方推出的@Observable宏，它天生支持泛型，且不需要依赖Obj-C运行时：

// 用@Observable标记你的ViewModel类
@Observable class YourViewModel {
    var notifierData: NotifierData<ModelTypeStruct> = NotifierData()
    // 其他属性和逻辑
}

// 在视图中用.onChange监听变化
struct YourView: View {
    @State private var viewModel = YourViewModel()
    
    var body: some View {
        // 你的视图内容
        .onChange(of: viewModel.notifierData) { oldValue, newValue in
            // 处理notifierData的变化
        }
    }
}

这种方式不仅解决了泛型的问题，代码也更简洁，是SwiftUI场景下的最优解。

内容的提问来源于stack exchange，提问作者Congruent Tech. UG