MapKit启动无法获取定位：kCLErrorDomain error 1问题求助

需求：App启动时获取用户位置，让MapKit的MapView居中显示该位置，但启动时报错：Failed to find user's location: The operation couldn’t be completed. (kCLErrorDomain error 1.)

附原实现代码：

原LocationManager代码 #

class LocationManager: NSObject, ObservableObject, CLLocationManagerDelegate {
    @Published var location: CLLocationCoordinate2D?
    private let locationManager = CLLocationManager()
    
    override init() {
        super.init()
        self.locationManager.delegate = self
        self.locationManager.desiredAccuracy = kCLLocationAccuracyBest
        self.locationManager.requestWhenInUseAuthorization()
        self.locationManager.startUpdatingLocation()
    }
    
    func locationManager(_ manager: CLLocationManager, didUpdateLocations locations: [CLLocation]) {
        locations.last.map {
            self.location = CLLocationCoordinate2D(latitude: $0.coordinate.latitude, longitude: $0.coordinate.longitude)
        }
    }
    
    func locationManagerDidChangeAuthorization(_ manager: CLLocationManager) {
            if locationManager.authorizationStatus == .authorizedWhenInUse ||
                locationManager.authorizationStatus == .authorizedAlways {
                locationManager.requestLocation()
            }
    }
    
    func locationManager(_ manager: CLLocationManager, didFailWithError error: Error) {
           print("Failed to find user's location: \(error.localizedDescription)")
       }

}

原MapView代码 #

struct MapView: View {
    @ObservedObject var locationManager = LocationManager()
    var body: some View {
        Map(initialPosition: .region(region))
            .onAppear {
                            // Update region based on locationManager's location
                            if let userLocation = locationManager.location {
                                self.region = MKCoordinateRegion(
                                    center: userLocation,
                                    span: MKCoordinateSpan(latitudeDelta: 0.2, longitudeDelta: 0.2)
                                )
                            }
                        }
    }
    @State private var region: MKCoordinateRegion = MKCoordinateRegion(
            center: CLLocationCoordinate2D(latitude: 34.011_286, longitude: -116.166_868),
            span: MKCoordinateSpan(latitudeDelta: 0.2, longitudeDelta: 0.2)
        )
}

#Preview {
    MapView()
}

错误原因分析 #

kCLErrorDomain error 1对应的是用户未授权位置访问，结合代码来看还有几个逻辑问题：

1. Info.plist中缺少位置权限描述，系统会直接拒绝位置请求；
2. LocationManager初始化时直接调用startUpdatingLocation，此时还未拿到用户授权，触发错误；
3. locationManagerDidChangeAuthorization中重复调用requestLocation，和startUpdatingLocation冲突；
4. MapView仅在onAppear时检查位置，此时可能位置还未更新，导致地图无法居中到用户位置；
5. 使用@ObservedObject管理LocationManager，View重建时会重新初始化实例，破坏定位逻辑。

解决方案 #

1. 补充Info.plist位置权限描述 #

在Info.plist中添加以下键值对（根据需求选择）：

• NSLocationWhenInUseUsageDescription：字符串值，说明App需要位置权限的原因，例如"需要获取您的位置以在地图上显示当前位置"；
• 如果需要后台定位，额外添加NSLocationAlwaysAndWhenInUseUsageDescription。

2. 修正LocationManager逻辑 #

调整授权和定位启动的顺序，避免未授权时触发定位：

class LocationManager: NSObject, ObservableObject, CLLocationManagerDelegate {
    @Published var location: CLLocationCoordinate2D?
    private let locationManager = CLLocationManager()
    
    override init() {
        super.init()
        locationManager.delegate = self
        locationManager.desiredAccuracy = kCLLocationAccuracyBest
        // 先请求授权，不直接启动定位
        locationManager.requestWhenInUseAuthorization()
    }
    
    func locationManager(_ manager: CLLocationManager, didUpdateLocations locations: [CLLocation]) {
        guard let latestLocation = locations.last else { return }
        location = latestLocation.coordinate
        // 若仅需一次定位，可在此停止更新：locationManager.stopUpdatingLocation()
    }
    
    func locationManagerDidChangeAuthorization(_ manager: CLLocationManager) {
        switch manager.authorizationStatus {
        case .authorizedWhenInUse, .authorizedAlways:
            // 授权成功后启动定位
            locationManager.startUpdatingLocation()
        case .denied, .restricted:
            print("位置权限被拒绝或受限")
        case .notDetermined:
            break
        @unknown default:
            break
        }
    }
    
    func locationManager(_ manager: CLLocationManager, didFailWithError error: Error) {
        print("Failed to find user's location: \(error.localizedDescription)")
    }
}

3. 修正MapView更新逻辑 #

用@StateObject保证LocationManager生命周期，监听位置变化实时更新地图：

struct MapView: View {
    // 用@StateObject（iOS14+）保证LocationManager与View生命周期一致
    @StateObject private var locationManager = LocationManager()
    @State private var region: MKCoordinateRegion = MKCoordinateRegion(
        center: CLLocationCoordinate2D(latitude: 34.011_286, longitude: -116.166_868),
        span: MKCoordinateSpan(latitudeDelta: 0.2, longitudeDelta: 0.2)
    )
    
    var body: some View {
        Map(initialPosition: .region(region))
            .onReceive(locationManager.$location) { newLocation in
                // 监听位置变化，实时更新地图区域
                guard let userLocation = newLocation else { return }
                region = MKCoordinateRegion(
                    center: userLocation,
                    span: MKCoordinateSpan(latitudeDelta: 0.2, longitudeDelta: 0.2)
                )
            }
    }
}

#Preview {
    MapView()
}

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