自定义Annotation View类型转换在iOS10及以下始终返回nil

问题根源 #

你现在的代码里，当dequeueReusableAnnotationView返回nil时，你创建的是MKAnnotationView父类实例，然后尝试强制转换为子类CustomAnnotationView——这在iOS10及以下系统里是完全行不通的，因为父类对象不能直接转换成子类类型，必然返回nil。iOS11可能因为系统内部的一些优化或者你无意中的其他配置（比如提前注册了重用类）才看似正常，但这不是正确的写法。

正确的解决方案 #

方案1：直接初始化子类实例 #

当需要创建新的标注视图时，直接初始化CustomAnnotationView，而不是父类转子类：

if annotation is CustomAnnotation {
    var annotationView = mapView.dequeueReusableAnnotationView(withIdentifier: "customAnnotation") as? CustomAnnotationView
    
    if annotationView == nil {
        // 直接初始化子类，而不是父类
        annotationView = CustomAnnotationView(annotation: annotation, reuseIdentifier: "customAnnotation")
    }
    
    guard let view = annotationView else { return nil }
    view.passedAnnotation = annotation as! CustomAnnotation
    view.setUpAnnotation()
    return view
}
// 处理其他标注类型
return nil

方案2：提前注册重用类（更推荐） #

在视图控制器的viewDidLoad中提前注册你的自定义标注视图类，这样dequeueReusableAnnotationView会直接返回子类实例，不需要手动判断nil：

override func viewDidLoad() {
    super.viewDidLoad()
    // 注册自定义标注视图
    mapView.register(CustomAnnotationView.self, forAnnotationViewWithReuseIdentifier: "customAnnotation")
}

// 然后在viewForAnnotation中：
func mapView(_ mapView: MKMapView, viewFor annotation: MKAnnotation) -> MKAnnotationView? {
    guard let customAnnotation = annotation as? CustomAnnotation else {
        // 返回系统默认标注或nil
        return nil
    }
    
    let annotationView = mapView.dequeueReusableAnnotationView(withIdentifier: "customAnnotation", for: customAnnotation) as! CustomAnnotationView
    annotationView.passedAnnotation = customAnnotation
    annotationView.setUpAnnotation()
    return annotationView
}

额外说明 #

• Apple文档里说MKAnnotationView(annotation:reuseIdentifier:)支持iOS3+，但这只是说这个初始化方法本身可用，并不意味着父类实例可以转换成子类——这是Swift/OC的类型转换基本规则，和系统版本无关，只是iOS11可能因为某些隐性逻辑让你没遇到问题，但这不是标准写法。
• 确保你的CustomAnnotationView正确继承自MKAnnotationView，并且没有重写初始化方法时遗漏必要的参数。

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