给MKAnnotationView添加Layer Mask后其标题弹窗无法显示如何解决

问题原因 #

给MKAnnotationView的根layer设置全局mask时，会同步裁剪annotation关联的callout弹出视图：callout在渲染时属于annotation view的子层级，你设置的椭圆mask仅覆盖了annotation本身的可视区域，超出该区域的callout部分会被直接裁剪隐藏，也就出现了点击后弹窗不显示的问题。

修复方案 #

方案1：仅对自定义内容层加mask（通用推荐） #

不要修改annotation view根layer的mask属性，把自定义展示内容（图片、自定义样式视图等）放到单独的子视图中，只给这个子视图加mask即可：

func mapView(_ mapView: MKMapView, viewFor annotation: MKAnnotation) -> MKAnnotationView? {
    // ... 原有annotation view复用、初始化逻辑
    guard let mkAnnotationView = mkAnnotationView else { return nil }
    let rect = CGRect(x: 0, y: 0, width: 40, height: 40) // 替换为你实际的尺寸
    
    // 新增独立的自定义内容承载视图
    let customContent = UIView(frame: rect)
    customContent.backgroundColor = backgroundColor
    mkAnnotationView.addSubview(customContent)
    
    // 仅给自定义内容视图加mask，不影响根layer的子视图（callout）渲染
    let shapeLayer = CAShapeLayer()
    shapeLayer.path = UIBezierPath(ovalIn: rect).cgPath
    customContent.layer.mask = shapeLayer
    
    return mkAnnotationView
}

如果项目最低支持iOS 14及以上版本，可以直接使用系统提供的contentView承载自定义内容，callout本身不在contentView层级内，给contentView加mask不会对callout产生任何影响：

// iOS 14+ 适配写法
let shapeLayer = CAShapeLayer()
shapeLayer.path = UIBezierPath(ovalIn: rect).cgPath
mkAnnotationView.contentView.layer.mask = shapeLayer

方案2：用cornerRadius替代mask实现圆角/圆形效果 #

如果你的需求只是实现圆形、圆角样式，直接使用子视图的cornerRadius属性即可，性能优于CAShapeLayer mask，也不会影响callout展示：

customContent.layer.cornerRadius = rect.width / 2 // 圆形效果
customContent.clipsToBounds = true

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