SwiftUI中CLLocationManager的didUpdateLocations未触发问题

问题描述 #

编写了LocationManager类用于获取用户位置并调用其他方法，但didUpdateLocations代理方法始终未触发。已配置定位权限（Info.plist标识符已设置）、设备定位服务已开启，且执行了startUpdatingLocation方法。在SwiftUI视图的onAppear中调用fetchLocation，模拟器（已设置测试位置）与真机均出现该问题。

原代码 #

LocationManager类 #

class LocationManager: NSObject, CLLocationManagerDelegate {

let manager = CLLocationManager()

func fetchLocation() {
    
    manager.desiredAccuracy = kCLLocationAccuracyBest
    manager.delegate = self
    manager.requestWhenInUseAuthorization()
    
    if CLLocationManager.locationServicesEnabled(),
       (manager.authorizationStatus == .authorizedAlways || manager.authorizationStatus == .authorizedWhenInUse) {
        
        manager.startUpdatingLocation()
    }
}

func locationManager(_ manager: CLLocationManager, didUpdateLocations locations: [CLLocation]) {
    
    if let location = locations.first {
        
        manager.stopUpdatingLocation()
        
        Weather().fetchWeatherData(location: location)
    }
}

func locationManager(_ manager: CLLocationManager, didFailWithError error: Error) {
    
    print(error)
}

SwiftUI调用代码 #

var body: some View {
            
    ZStack { ... }
    .ignoresSafeArea()
    .onAppear {
        
        LocationManager().fetchLocation()
    }
}

问题根源 #

1. 临时实例被销毁：onAppear中创建的LocationManager()是局部变量，方法执行完成后会被自动释放，导致CLLocationManager的代理对象不存在，无法接收回调通知。
2. 权限请求异步处理缺失：requestWhenInUseAuthorization()是异步操作，调用后不会立即返回权限状态，此时直接判断权限大概率还未授权，导致startUpdatingLocation()未被执行。

修复方案 #

修改后的LocationManager类 #

class LocationManager: NSObject, CLLocationManagerDelegate {
    let manager = CLLocationManager()
    
    override init() {
        super.init()
        // 初始化时完成基础配置
        manager.desiredAccuracy = kCLLocationAccuracyBest
        manager.delegate = self
    }
    
    func fetchLocation() {
        manager.requestWhenInUseAuthorization()
        // 提前检查定位服务状态
        if !CLLocationManager.locationServicesEnabled() {
            print("定位服务未开启，请在设置中启用")
            return
        }
    }
    
    // 监听权限状态变更，在授权通过后启动定位
    func locationManagerDidChangeAuthorization(_ manager: CLLocationManager) {
        switch manager.authorizationStatus {
        case .authorizedWhenInUse, .authorizedAlways:
            manager.startUpdatingLocation()
        case .denied, .restricted:
            print("定位权限被拒绝或受限，无法获取位置")
        case .notDetermined:
            // 等待用户选择权限，无需额外操作
            break
        @unknown default:
            break
        }
    }
    
    func locationManager(_ manager: CLLocationManager, didUpdateLocations locations: [CLLocation]) {
        if let location = locations.first {
            manager.stopUpdatingLocation()
            Weather().fetchWeatherData(location: location)
        }
    }
    
    func locationManager(_ manager: CLLocationManager, didFailWithError error: Error) {
        print("定位失败：\(error.localizedDescription)")
    }
}

修改后的SwiftUI调用代码 #

struct ContentView: View {
    // 将LocationManager实例声明为视图属性，确保持有不被释放
    private let locationManager = LocationManager()
    
    var body: some View {
        ZStack { /* 原视图内容 */ }
            .ignoresSafeArea()
            .onAppear {
                locationManager.fetchLocation()
            }
    }
}

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