AppIntent中CLLocationManager的didUpdateLocations未触发问题求助

问题背景 #

我开发了一款面向搭车旅行者的iOS应用（基于SwiftUI+SwiftData），目标是通过iOS快捷指令的AddTripRecord AppIntent创建包含当前位置的上下车记录。应用内使用同类IntentLocationManager可以正常获取位置，但在AppIntent中调用时，didUpdateLocations方法始终无法触发。

核心问题分析 #

1. 对象生命周期不足：perform方法中创建的IntentLocationManager是局部变量，异步请求位置的过程中，该实例可能被提前释放，导致CLLocationManager的弱引用delegate失效，无法收到回调。
2. 权限处理逻辑缺陷：原代码在init中直接调用checkAuthorizationStatus并请求权限，但权限请求是异步操作，此时立刻调用requestLocation可能权限尚未生效；同时缺少iOS 14+要求的locationManagerDidChangeAuthorization回调，无法监听权限状态的变更。
3. 不必要的位置更新调用：checkAuthorizationStatus中在authorizedAlways状态下调用startUpdatingLocation，会持续更新位置，与单次requestLocation的需求冲突，反而可能干扰回调触发。

解决方案 #

1. 延长IntentLocationManager生命周期 #

在perform方法中保持IntentLocationManager的强引用，直到异步位置请求完成，避免实例提前被释放。

2. 修正权限处理逻辑 #

• 添加locationManagerDidChangeAuthorization回调，监听权限状态变化，确保权限到位后再执行位置请求。
• 调整权限请求流程，等待权限确认后再触发requestLocation，而非在init中直接执行。

3. 优化位置请求逻辑 #

移除不必要的startUpdatingLocation调用，仅在需要单次位置时使用requestLocation。

修正后的完整代码 #

import Foundation
import AppIntents
import CoreLocation

class IntentLocationManager: NSObject, ObservableObject, CLLocationManagerDelegate {
    var locationContinuation: CheckedContinuation<CLLocationCoordinate2D?, Error>?
    let manager = CLLocationManager()
    @Published var lastLocation: CLLocation?
    @Published var locationError: CLError?
    @Published var authorizationStatus: CLAuthorizationStatus

    override init() {
        authorizationStatus = manager.authorizationStatus
        super.init()
        manager.delegate = self
        manager.desiredAccuracy = kCLLocationAccuracyBest
    }

    func requestLocation() async throws -> CLLocationCoordinate2D? {
        // 先确认权限状态
        let status = await requestAuthorization()
        guard status == .authorizedAlways || status == .authorizedWhenInUse else {
            throw CLError(.denied)
        }
        
        return try await withCheckedThrowingContinuation { continuation in
            locationContinuation = continuation
            manager.requestLocation()
        }
    }

    // 异步请求权限
    private func requestAuthorization() async -> CLAuthorizationStatus {
        await withCheckedContinuation { continuation in
            switch manager.authorizationStatus {
            case .notDetermined:
                manager.requestWhenInUseAuthorization()
                self.authorizationStatus = .notDetermined
            case .authorizedWhenInUse, .authorizedAlways, .restricted, .denied:
                continuation.resume(returning: manager.authorizationStatus)
            @unknown default:
                continuation.resume(returning: .locationUnknown)
            }
            // 如果已经有权限，直接返回
            if manager.authorizationStatus != .notDetermined {
                continuation.resume(returning: manager.authorizationStatus)
            }
        }
    }

    func locationManager(_ manager: CLLocationManager, didUpdateLocations locations: [CLLocation]) {
        NSLog(String(describing: locations.first?.coordinate))
        locationContinuation?.resume(returning: locations.first?.coordinate)
        locationContinuation = nil // 避免重复调用
    }

    func locationManager(_ manager: CLLocationManager, didFailWithError error: Error) {
        NSLog(error.localizedDescription)
        locationContinuation?.resume(throwing: error)
        locationContinuation = nil
    }

    // iOS 14+ 必须实现的权限变更回调
    func locationManagerDidChangeAuthorization(_ manager: CLLocationManager) {
        authorizationStatus = manager.authorizationStatus
        // 处理等待权限的请求
        if let continuation = locationContinuation, manager.authorizationStatus != .notDetermined {
            if manager.authorizationStatus == .authorizedAlways || manager.authorizationStatus == .authorizedWhenInUse {
                manager.requestLocation()
            } else {
                continuation.resume(throwing: CLError(.denied))
                locationContinuation = nil
            }
        }
    }
}

struct AddTripRecord: AppIntent {
    static var title = LocalizedStringResource("Add a new trip record")
    
    @Parameter(title: "Trip")
    var trip: TripIntentItem
    
    @Parameter(title: "Record Type")
    var recordType: TripRecordType
    
    func perform() async throws -> some IntentResult {
        // 保持强引用，直到异步操作完成
        let locationManager = IntentLocationManager()
        
        guard let currentLocation = try await locationManager.requestLocation() else {
            return .result(value: "Failed to get current location")
        }
        
        let record = TripRecord(type: recordType, content: "", location: currentLocation)
        // trip.records.append(record)
        // try! await SharedDatabase.shared.database.save()
        
        return .result(value: "Trip record successfully saved!")
    }
}

额外注意事项 #

• 确保Info.plist中添加了NSLocationWhenInUseUsageDescription和NSLocationAlwaysAndWhenInUseUsageDescription权限描述，否则权限请求会被直接拒绝。
• 在快捷指令中测试时，需要确保应用已经获得位置权限，首次调用时会弹出权限请求，需用户手动授权。

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