为什么成功计算路线后MKMapViewDelegate未响应，路线无法在地图显示？

你遇到的是UIKit MapKit适配SwiftUI时的典型错误，核心是MKMapViewDelegate的归属和线程处理不符合SwiftUI的要求，具体解决步骤如下：

1. 代理对象归属错误（最高概率原因） #

Sean的原版教程是UIKit项目，MKMapViewDelegate可以直接放在ViewController中实现；但SwiftUI中封装MKMapView必须使用UIViewRepresentable，代理方法必须放在其内部的Coordinator中，不能放在ViewModel里。
正确的Map封装结构示例：

struct MapView: UIViewRepresentable {
    // 接收ViewModel传递的路线数据
    @Binding var routePolyline: MKPolyline?
    
    // 生成协调器，专门处理MapKit代理逻辑
    func makeCoordinator() -> Coordinator {
        Coordinator(self)
    }
    
    func makeUIView(context: Context) -> MKMapView {
        let mapView = MKMapView()
        // 代理必须绑定到Coordinator实例
        mapView.delegate = context.coordinator
        return mapView
    }
    
    func updateUIView(_ uiView: MKMapView, context: Context) {
        // 路线数据更新时添加覆盖层
        guard let polyline = routePolyline else { return }
        uiView.addOverlay(polyline, level: .aboveRoads)
        uiView.setVisibleMapRect(polyline.boundingMapRect, animated: true)
    }
    
    // Coordinator实现所有MKMapViewDelegate方法
    class Coordinator: NSObject, MKMapViewDelegate {
        var parent: MapView
        
        init(_ parent: MapView) {
            self.parent = parent
        }
        
        func mapView(_ mapView: MKMapView, rendererFor overlay: MKOverlay) -> MKOverlayRenderer {
            let renderer = MKPolylineRenderer(overlay: overlay as! MKPolyline)
            renderer.strokeColor = .blue
            renderer.lineWidth = 5.0
            return renderer
        }
    }
}

2. 非主线程操作UI #

MKDirections.calculate的回调默认在后台队列执行，所有MapKit的UI操作（添加覆盖层、调整地图区域）必须切到主队列，否则不会触发渲染逻辑：

// ViewModel中的getDirections方法修改
directions.calculate { calcResponse, error in
    guard let response = calcResponse else { return }
    // 切换到主线程更新UI相关数据
    DispatchQueue.main.async {
        for route in response.routes {
            print("Route \(route.name) is \(route.distance) long")
            // 将计算得到的路线赋值给@Binding变量，驱动UI更新
            self.routePolyline = route.polyline
        }
    }
}

3. 其他检查点 #

• 确认MKMapView实例全局唯一，不要在每次View刷新时重新创建新的Map实例，否则之前的代理设置和覆盖层都会失效
• 确认代理对象没有被提前释放：MKMapView的delegate是弱引用属性，如果实现代理的对象（如Coordinator）没有被持有，会被系统自动回收，导致代理方法不触发

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