Swift开发：地图视图控制台出现Null Island错误排查求助

核心错误：Null Island日志 #

原因分析 #

• Annotation坐标错误引用：Map组件的annotationContent闭包中，未使用当前循环的location参数坐标，反而引用全局的self.mapCoordinate。当mapCoordinate未初始化或加载延迟时，会 fallback 到默认的CLLocationCoordinate2D()（即纬度0、经度0的Null Island位置）。
• 初始区域未合理设置：mapRegion初始化为空的MKCoordinateRegion()，即便被ProgressView遮挡，仍可能被MapKit内部检测到无效坐标。
• 冗余可选值处理：makeMap中已判断location != nil，却仍使用location?.latitude ?? 0.0这类冗余代码，增加出错风险。

其他日志说明 #

• com.apple.accounts Code=7：属于系统级账户服务错误，多与地图服务权限缓存或系统配置有关，不影响功能，可忽略或重启设备解决。
• PipelineLibrary错误：Metal渲染管线缓存问题，属于系统底层日志，无需代码层面处理。

修复后的代码 #

import Combine
import CoreLocation
import MapKit
import SwiftUI

struct MapViewLocation: Identifiable {
    let id = UUID()
    var coordinate: CLLocationCoordinate2D
}

struct MapViewSmall: View {
    @State var address: String
    @State private var mapCoordinate: CLLocationCoordinate2D? = nil
    @State private var mapIsLoading: Bool = true
    @State private var mapLocations: [MapViewLocation] = []
    // 初始化时设置有效默认坐标（示例为旧金山）
    @State private var mapRegion: MKCoordinateRegion = MKCoordinateRegion(
        center: CLLocationCoordinate2D(latitude: 37.7749, longitude: -122.4194),
        span: MKCoordinateSpan(latitudeDelta: 0.01, longitudeDelta: 0.01)
    )
    @State private var mapSuccess: Bool = false

    var body: some View {
        ZStack {
            if mapIsLoading {
                ProgressView()
                    .progressViewStyle(CircularProgressViewStyle())
                    .scaleEffect(0.8)
            } else {
                if mapSuccess {
                    Map(
                        coordinateRegion: $mapRegion,
                        interactionModes: [.pan],
                        annotationItems: mapLocations,
                        annotationContent: { location in
                            // 使用当前循环item的坐标，而非全局变量
                            MapPin(coordinate: location.coordinate, tint: .red)
                        }
                    )
                    .frame(width: 100, height: 100)
                    .cornerRadius(9)
                    .onTapGesture {
                        let request = MKLocalSearch.Request()
                        request.naturalLanguageQuery = address
                        let search = MKLocalSearch(request: request)
                        search.start { response, error in
                            guard let response = response, let firstItem = response.mapItems.first else { return }
                            let mapItem = MKMapItem(placemark: firstItem.placemark)
                            mapItem.name = address
                            mapItem.openInMaps(launchOptions: [MKLaunchOptionsDirectionsModeKey: MKLaunchOptionsDirectionsModeDriving])
                        }
                    }
                } else {
                    Image(systemName: "mappin.slash.circle")
                        .resizable()
                        .aspectRatio(contentMode: .fit)
                        .frame(width: 100, height: 100)
                        .foregroundColor(.red)
                }
            }
        }
        .onAppear {
            mapIsLoading = true
            Task {
                await makeMap()
            }
        }
    }

    func getLocation(address: String, completion: @escaping (_ location: CLLocationCoordinate2D?) -> Void) {
        let geocoder = CLGeocoder()
        geocoder.geocodeAddressString(address) { placemarks, error in
            if let error = error {
                print(error.localizedDescription)
                completion(nil)
                return
            }
            guard let placemark = placemarks?.first, let coordinate = placemark.location?.coordinate else {
                completion(nil)
                return
            }
            completion(coordinate)
        }
    }

    func makeMap() async {
        getLocation(address: address) { location in
            guard let location = location else {
                mapSuccess = false
                mapIsLoading = false
                return
            }

            // 直接使用已解包的有效坐标，去掉冗余fallback
            mapCoordinate = location
            mapRegion = MKCoordinateRegion(
                center: location,
                span: MKCoordinateSpan(latitudeDelta: 0.01, longitudeDelta: 0.01)
            )
            // 直接赋值数组，避免重复添加标注点
            mapLocations = [MapViewLocation(coordinate: location)]
            mapSuccess = true
            mapIsLoading = false
        }
    }
}

struct TestView: View {
    var body: some View {
        MapViewSmall(address: "1 Infinite Loop, Cupertino CA 95014, United States")
    }
}

关键修复点 #

• 修正annotationContent的坐标引用，使用当前循环的location.coordinate确保标注点坐标正确。
• 为mapRegion初始化真实有效坐标，避免初始无效坐标触发Null Island日志。
• 简化可选值处理逻辑，去掉冗余的?? 0.0 fallback代码。
• 将mapLocations.append改为直接赋值，防止重复添加标注点。

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