MKMarkerAnnotationView不显示：标注视图Frame为(0 0; 0 0)

我帮你排查下问题所在，主要是视图注册和复用逻辑错误，再加上几个容易忽略的细节，导致标注视图无法正常显示：

核心问题分析 #

1. 注册的视图类与实际使用不匹配
   你注册的是MKAnnotationView类，但在viewForAnnotation里试图创建MKMarkerAnnotationView，复用池里找不到对应类型的视图，导致后续复用逻辑出错。

2. viewForAnnotation里的代码顺序错误
   你先初始化了一个MKMarkerAnnotationView，但紧接着用dequeueReusableAnnotationViewWithIdentifier覆盖了这个对象——因为你注册的是MKAnnotationView类，复用池会创建MKAnnotationView实例而非MKMarkerAnnotationView，这就导致拿到的视图类型不对，且没有默认尺寸（MKMarkerAnnotationView有自带默认frame，MKAnnotationView需要手动设置）。

3. 潜在的主线程问题
   fetchData里的网络回调是在子线程执行的，直接调用addAnnotation和showAnnotations属于UI操作，必须在主线程执行，否则可能导致标注不显示或异常。

4. Cafe类的MKAnnotation协议实现
   确保你的Cafe类正确实现了MKAnnotation协议的coordinate属性（可读），如果coordinate不可读或未正确赋值，地图无法定位标注，自然也不会显示。

修复后的代码 #

1. 修正viewDidLoad里的注册代码 #

把注册的类改成MKMarkerAnnotationView：

- (void)viewDidLoad { 
    [super viewDidLoad]; 
    [self.cafeMap setShowsUserLocation:YES]; 
    [self.locationManager requestWhenInUseAuthorization]; 
    self.cafes = [NSMutableArray array]; 
    [self fetchData]; 
    // 注册MKMarkerAnnotationView而非MKAnnotationView
    [self.cafeMap registerClass:[MKMarkerAnnotationView class] forAnnotationViewWithReuseIdentifier:@"marker"]; 
} 

2. 修复viewForAnnotation方法的逻辑 #

先尝试复用，没有的话再创建新视图，同时避免类型错误：

- (MKAnnotationView *)mapView:(MKMapView *)mapView viewForAnnotation:(id<MKAnnotation>)annotation { 
    if ([annotation isKindOfClass:[MKUserLocation class]]) { 
        return nil; 
    } 

    // 先尝试复用视图
    MKMarkerAnnotationView *marker = (MKMarkerAnnotationView*) [mapView dequeueReusableAnnotationViewWithIdentifier:@"marker" forAnnotation:annotation];
    
    // 如果复用池为空，手动创建（注册类后dequeue一般不会返回nil，保险起见加上）
    if (!marker) {
        marker = [[MKMarkerAnnotationView alloc] initWithAnnotation:annotation reuseIdentifier:@"marker"];
    }

    UIButton *button = [UIButton buttonWithType:UIButtonTypeInfoLight]; 
    marker.rightCalloutAccessoryView = button; 
    marker.enabled = YES; 
    marker.canShowCallout = YES; 

    NSLog(@"MARKER:%@",marker); 
    return marker; 
} 

3. 确保fetchData在主线程操作UI #

修改网络回调里的代码，包裹到主线程：

-(void)fetchData{ 
    [self.networkManager fetchCafeData:^(NSArray * _Nonnull businesses) { 
        // 切换到主线程执行UI操作
        dispatch_async(dispatch_get_main_queue(), ^{
            for (NSDictionary* cafeInfo in businesses) { 
                Cafe *cafe = [[Cafe alloc]initWithCafeInfo:cafeInfo]; 
                [self.cafes addObject:cafe]; 
            } 
            for (Cafe *cafe in self.cafes) { 
                [self.cafeMap addAnnotation:cafe]; 
            } 
            [self.cafeMap showAnnotations:self.cafes animated:YES]; 
        });
    }]; 
} 

4. 检查Cafe类的MKAnnotation实现 #

确保你的Cafe类有正确的coordinate属性，比如：

@interface Cafe : NSObject <MKAnnotation>
@property (nonatomic, readonly) CLLocationCoordinate2D coordinate;
// 可选的标题副标题
@property (nonatomic, copy, nullable) NSString *title;
@property (nonatomic, copy, nullable) NSString *subtitle;
@end

@implementation Cafe
- (instancetype)initWithCafeInfo:(NSDictionary *)cafeInfo {
    self = [super init];
    if (self) {
        // 从cafeInfo里解析经纬度，赋值给coordinate
        CLLocationDegrees lat = [cafeInfo[@"latitude"] doubleValue];
        CLLocationDegrees lon = [cafeInfo[@"longitude"] doubleValue];
        _coordinate = CLLocationCoordinate2DMake(lat, lon);
        // 赋值标题副标题
        _title = cafeInfo[@"name"];
        _subtitle = cafeInfo[@"address"];
    }
    return self;
}
@end

验证修复 #

做完这些修改后，重新运行项目：

• 标注视图的frame应该会自动设置为MKMarkerAnnotationView的默认尺寸（比如40x40左右）
• 地图上会显示出咖啡馆的标记，点击还能弹出callout

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