Swift：如何更新自定义MKAnnotation标注气泡中的数据？

这个问题的核心在于：当你更新CustomPin的title、subtitle等自定义属性时，MKMapView并不会自动刷新已显示的标注气泡——尤其是你自定义的detailCalloutAccessoryView，它只会在viewFor annotation方法初始化标注视图时被创建一次，之后属性变化不会触发它的更新。而位置动画正常是因为coordinate属性已经标记为@objc dynamic，MKMapView通过KVO监听了这个属性的变化。

下面是两种优雅的解决方案，不需要移除再添加标注导致闪烁：

方案一：手动更新对应AnnotationView的Callout视图 #

这种方法最简单直接，在更新CustomPin属性后，找到对应的标注视图，重新生成并设置自定义气泡视图，同时如果气泡正处于显示状态，重新选中标注以刷新界面。

步骤1：让CustomPin的属性支持KVO（可选但推荐） #

首先把CustomPin中需要更新的属性都标记为@objc dynamic，确保KVO能监测到变化（虽然手动更新不需要依赖这个，但能让标注的默认title/subtitle也自动同步）：

class CustomPin: NSObject, MKAnnotation {
    @objc dynamic var coordinate: CLLocationCoordinate2D
    @objc dynamic var title: String?
    @objc dynamic var subtitle: String?
    @objc dynamic var userId: String?
    @objc dynamic var distance: CLLocationDistance?
    
    init(coordinate: CLLocationCoordinate2D, title: String, subtitle: String, userId: String, distance: CLLocationDistance?) {
        self.coordinate = coordinate
        self.title = title
        self.subtitle = subtitle
        self.userId = userId
        self.distance = distance
        super.init()
    }
}

步骤2：修改更新方法，手动刷新Callout #

在secondFunctionThatGetsTheNewLocation方法中，更新属性后添加刷新逻辑：

func secondFunctionThatGetsTheNewLocation(newCoordinate: CLLocationCoordinate2D, newDistance: CLLocationDistance) {
    for pin in customPins {
        // 更新标注属性
        pin.title = "second title"
        pin.subtitle = "second address"
        pin.distance = newDistance
        
        // 动画更新位置
        UIView.animate(withDuration: 1) {
            pin.coordinate = newCoordinate
        }
        
        // 手动刷新气泡视图
        DispatchQueue.main.async { [weak self] in
            guard let self = self, let annotationView = self.mapView.view(for: pin) else { return }
            
            // 重新生成自定义气泡视图并赋值
            annotationView.detailCalloutAccessoryView = self.createCallOutWithDataFrom(customPin: pin)
            
            // 如果当前气泡正在显示，先取消选中再重新选中以刷新界面
            if annotationView.isSelected {
                self.mapView.deselectAnnotation(pin, animated: false)
                self.mapView.selectAnnotation(pin, animated: true)
            }
        }
    }
}

方案二：通过KVO自动监听属性变化 #

这种方法更自动化，让标注视图监听CustomPin的属性变化，当属性更新时自动刷新气泡视图。

步骤1：修改CustomPin属性（同方案一） #

确保所有需要监听的属性都是@objc dynamic。

步骤2：在viewFor annotation中添加KVO观察者 #

在创建或复用标注视图时，给CustomPin添加属性观察者：

func mapView(_ mapView: MKMapView, viewFor annotation: MKAnnotation) -> MKAnnotationView? {
    if annotation.isKind(of: MKUserLocation.self) {
        return nil
    }
    guard let customPin = annotation as? CustomPin else {
        return nil
    }
    let reuseIdentifier = "CustomPin"
    var annotationView = mapView.dequeueReusableAnnotationView(withIdentifier: reuseIdentifier)
    
    if annotationView == nil {
        annotationView = MKAnnotationView(annotation: customPin, reuseIdentifier: reuseIdentifier)
        annotationView?.canShowCallout = true
        annotationView?.calloutOffset = CGPoint(x: -5, y: 5)
        annotationView?.rightCalloutAccessoryView = UIButton(type: .detailDisclosure)
        annotationView?.image = UIImage(named: "chevronImage")
        // 添加KVO观察者，监听需要更新的属性
        customPin.addObserver(annotationView!, forKeyPath: "title", options: [.new], context: nil)
        customPin.addObserver(annotationView!, forKeyPath: "subtitle", options: [.new], context: nil)
        customPin.addObserver(annotationView!, forKeyPath: "distance", options: [.new], context: nil)
    } else {
        // 移除旧标注的观察者，避免内存泄漏
        if let oldPin = annotationView?.annotation as? CustomPin {
            oldPin.removeObserver(annotationView!, forKeyPath: "title")
            oldPin.removeObserver(annotationView!, forKeyPath: "subtitle")
            oldPin.removeObserver(annotationView!, forKeyPath: "distance")
        }
        annotationView?.annotation = customPin
        // 给新标注添加观察者
        customPin.addObserver(annotationView!, forKeyPath: "title", options: [.new], context: nil)
        customPin.addObserver(annotationView!, forKeyPath: "subtitle", options: [.new], context: nil)
        customPin.addObserver(annotationView!, forKeyPath: "distance", options: [.new], context: nil)
    }
    
    annotationView?.detailCalloutAccessoryView = createCallOutWithDataFrom(customPin: customPin)
    return annotationView
}

步骤3：给MKAnnotationView添加KVO回调扩展 #

实现observeValue方法，当属性变化时刷新气泡：

extension MKAnnotationView {
    override open func observeValue(forKeyPath keyPath: String?, of object: Any?, change: [NSKeyValueChangeKey : Any]?, context: UnsafeMutableRawPointer?) {
        // 只处理CustomPin的属性变化
        guard let customPin = object as? CustomPin, 
              ["title", "subtitle", "distance"].contains(keyPath) else {
            super.observeValue(forKeyPath: keyPath, of: object, change: change, context: context)
            return
        }
        
        // 获取视图控制器实例，用于调用createCallOutWithDataFrom方法
        guard let parentVC = self.parentViewController as? YourViewControllerClass else { // 替换成你的视图控制器类名
            return
        }
        
        // 更新自定义气泡视图
        self.detailCalloutAccessoryView = parentVC.createCallOutWithDataFrom(customPin: customPin)
        
        // 如果气泡正在显示，刷新显示状态
        if self.isSelected {
            parentVC.mapView.deselectAnnotation(customPin, animated: false)
            parentVC.mapView.selectAnnotation(customPin, animated: true)
        }
    }
}

步骤4：清理观察者（避免内存泄漏） #

在视图控制器的deinit方法中，移除所有观察者：

deinit {
    for pin in customPins {
        if let annotationView = mapView.view(for: pin) {
            pin.removeObserver(annotationView, forKeyPath: "title")
            pin.removeObserver(annotationView, forKeyPath: "subtitle")
            pin.removeObserver(annotationView, forKeyPath: "distance")
        }
    }
}

两种方案都能解决气泡不更新的问题，方案一适合简单场景，代码量少；方案二更适合频繁更新的场景，一劳永逸。

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