SwiftUI中MapView显示标注项时拖动地图报错问题排查

这不是SwiftUI的bug，是代码使用方式导致的问题。

当你开启showsUserLocation: true并且绑定了$region时，地图在更新用户位置的过程中会尝试修改绑定的region变量，而这个修改操作发生在视图更新周期内，触发了SwiftUI的状态更新安全检查，所以控制台输出了警告。

解决方法 #

方法一：手动处理地图区域变化（简洁方案）

将Map的coordinateRegion参数改为非绑定形式，通过onRegionChange修饰符来更新region状态，避免在视图更新过程中修改状态：

import SwiftUI
import MapKit

struct MapItem: Identifiable {
    var id = UUID()
    var location: CLLocationCoordinate2D
}

struct ContentView: View {
    @State var region = MKCoordinateRegion(center: CLLocationCoordinate2D(latitude: 32.779167, longitude: -96.808891), span: MKCoordinateSpan(latitudeDelta: 1, longitudeDelta: 1))
    var items = [MapItem(location: CLLocationCoordinate2D(latitude: 32.779167, longitude: -96.808891))]
    
    var body: some View {
        Map(coordinateRegion: region, showsUserLocation: true, annotationItems: items) { item in
            MapAnnotation(coordinate: item.location) {
                Rectangle()
                    .frame(width: 10, height: 10)
                    .foregroundColor(.red)
            }
        }
        .onRegionChange(region) { newRegion in
            region = newRegion
        }
        .ignoresSafeArea()
    }
}

struct ContentView_Previews: PreviewProvider {
    static var previews: some View {
        ContentView()
    }
}

方法二：封装UIKit地图（灵活控制方案）

如果需要更精细的地图行为控制（比如跟随用户位置同时自定义区域逻辑），可以封装MKMapView的UIViewRepresentable，通过代理处理区域和用户位置变化，彻底避免SwiftUI状态更新冲突：

import SwiftUI
import MapKit

struct MapItem: Identifiable {
    var id = UUID()
    var location: CLLocationCoordinate2D
}

struct MapView: UIViewRepresentable {
    let items: [MapItem]
    @Binding var region: MKCoordinateRegion
    
    func makeUIView(context: Context) -> MKMapView {
        let mapView = MKMapView()
        mapView.showsUserLocation = true
        mapView.delegate = context.coordinator
        mapView.setRegion(region, animated: true)
        // 添加标注
        items.forEach { item in
            let annotation = MKPointAnnotation()
            annotation.coordinate = item.location
            mapView.addAnnotation(annotation)
        }
        return mapView
    }
    
    func updateUIView(_ uiView: MKMapView, context: Context) {
        // 按需处理标注更新逻辑
    }
    
    func makeCoordinator() -> Coordinator {
        Coordinator(self)
    }
    
    class Coordinator: NSObject, MKMapViewDelegate {
        var parent: MapView
        
        init(_ parent: MapView) {
            self.parent = parent
        }
        
        func mapView(_ mapView: MKMapView, regionDidChangeAnimated animated: Bool) {
            parent.region = mapView.region
        }
    }
}

struct ContentView: View {
    @State var region = MKCoordinateRegion(center: CLLocationCoordinate2D(latitude: 32.779167, longitude: -96.808891), span: MKCoordinateSpan(latitudeDelta: 1, longitudeDelta: 1))
    var items = [MapItem(location: CLLocationCoordinate2D(latitude: 32.779167, longitude: -96.808891))]
    
    var body: some View {
        MapView(items: items, region: $region)
            .ignoresSafeArea()
    }
}

struct ContentView_Previews: PreviewProvider {
    static var previews: some View {
        ContentView()
    }
}

补充说明 #

第一种方法适合大多数常规场景，代码简洁易维护；第二种方法适合需要自定义地图交互、标注逻辑的复杂场景，能完全规避状态更新冲突问题。

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