UIViewRepresentable封装MKMapView无法更新的问题求助

问题描述 #

开发中需要将UIKit的MKMapView嵌入SwiftUI视图（因SwiftUI原生Map不支持聚类功能），但修改绑定的persons数据源数组后，地图未同步更新：点击按钮移除数组首个元素时，数组确实变化，但updateUIView方法未触发，地图上的标注无变化。

原因分析 #

1. 错误的MKMapView存储方式：MapView结构体中定义private let mapView = MKMapView()作为存储属性，而结构体是值类型。当persons绑定变化时，SwiftUI会创建新的MapView实例，新实例的mapView是全新的MKMapView对象，但界面显示的仍是第一次makeUIView返回的旧mapView。此时updateUIView操作的是新实例的未显示mapView，完全无效。
2. updateUIView误用实例属性：在updateUIView方法中操作self.mapView而非传入的uiView参数，导致对非界面显示的mapView进行修改，无法同步到界面。

修复方案 #

修改后的MapView代码 #

struct MapView: UIViewRepresentable {
    @Binding var persons: [Person]
    
    init(persons: Binding<[Person]>) {
        self._persons = persons
        // other stuff
    }
    
    func makeUIView(context: Context) -> MKMapView {
        let mapView = MKMapView()
        mapView.delegate = context.coordinator
        mapView.register(MKMarkerAnnotationView.self, forAnnotationViewWithReuseIdentifier: "testAnnotation")
        return mapView
    }
    
    func updateUIView(_ uiView: MKMapView, context: Context) {
        // 移除旧标注并添加新标注
        uiView.removeAnnotations(uiView.annotations)
        uiView.addAnnotations(persons)
    }
}

extension MapView {
    func makeCoordinator() -> Coordinator {
        Coordinator(self)
    }
    
    class Coordinator: NSObject, MKMapViewDelegate {
        
        var parent: MapView
        
        init(_ parent: MapView) {
            self.parent = parent
        }

        func mapView(_ mapView: MKMapView, viewFor annotation: MKAnnotation) -> MKAnnotationView? {
            if let annotationView = mapView.dequeueReusableAnnotationView(withIdentifier: "testAnnotation", for: annotation) as? MKMarkerAnnotationView {
                annotationView.glyphImage = UIImage(systemName: "person")
                return annotationView
            }
            
            return nil
        }
    }
}

关键修改点 #

• 移除结构体中的private let mapView存储属性，改为在makeUIView内部创建MKMapView实例并返回，确保界面始终使用同一个mapView对象。
• updateUIView中使用方法参数uiView（即界面上的实际mapView）进行标注操作，保证修改能同步到界面。
• 移除不必要的DispatchQueue.main.async，因为updateUIView本身就在主线程执行。

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