iOS 16中MKMarkerAnnotationView标记遮挡图片，设置透明底色无效怎么办？

原因分析 #

iOS 16 Beta 3 对 MKMarkerAnnotationView 的内部渲染逻辑做了调整，之前通过设置 markerTintColor = UIColor.clear 来隐藏气泡的方式在这个版本中不再可靠。系统可能会忽略透明色设置，默认渲染气泡背景；部分注解出现随机颜色气泡、部分正常的情况，大概率和地图注解视图的复用机制有关——复用池中的视图残留了旧状态，导致新注解的样式设置未完全生效。

解决方法 #

方法1：强制隐藏标记气泡 #

直接使用官方提供的 markerVisibility 属性完全关闭气泡显示，这比仅设置透明色的方案更可靠：

self.glyphImage = myImage
self.glyphText = ""
self.glyphTintColor = UIColor.clear
self.markerTintColor = UIColor.clear
self.markerVisibility = .hidden // 新增该行，强制隐藏气泡

方法2：确保注解视图复用状态正确 #

如果使用 dequeueReusableAnnotationView(withIdentifier:for:) 复用视图，务必在每次返回视图前重置所有相关属性，避免复用残留状态：

func mapView(_ mapView: MKMapView, viewFor annotation: MKAnnotation) -> MKAnnotationView? {
    guard let customAnnotation = annotation as? YourAnnotationType else { return nil }
    
    let identifier = "MarkerAnnotation"
    let annotationView: MKMarkerAnnotationView
    if let dequeuedView = mapView.dequeueReusableAnnotationView(withIdentifier: identifier) as? MKMarkerAnnotationView {
        annotationView = dequeuedView
        // 重置所有可能影响样式的属性
        annotationView.glyphImage = nil
        annotationView.glyphText = ""
        annotationView.markerTintColor = .clear
        annotationView.glyphTintColor = .clear
        annotationView.markerVisibility = .hidden
    } else {
        annotationView = MKMarkerAnnotationView(annotation: customAnnotation, reuseIdentifier: identifier)
        annotationView.glyphText = ""
        annotationView.glyphTintColor = .clear
        annotationView.markerTintColor = .clear
        annotationView.markerVisibility = .hidden
    }
    annotationView.glyphImage = customAnnotation.myImage
    return annotationView
}

方法3：改用MKAnnotationView（更稳定） #

如果Beta版本的MKMarkerAnnotationView仍有问题，可以直接使用基础的MKAnnotationView，完全自定义显示内容，不受系统Marker逻辑影响：

func mapView(_ mapView: MKMapView, viewFor annotation: MKAnnotation) -> MKAnnotationView? {
    guard let customAnnotation = annotation as? YourAnnotationType else { return nil }
    
    let identifier = "CustomAnnotation"
    let annotationView: MKAnnotationView
    if let dequeuedView = mapView.dequeueReusableAnnotationView(withIdentifier: identifier) {
        annotationView = dequeuedView
        annotationView.image = nil
    } else {
        annotationView = MKAnnotationView(annotation: customAnnotation, reuseIdentifier: identifier)
    }
    annotationView.image = customAnnotation.myImage
    return annotationView
}

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