iOS调用geocodeAddressString时CLGeocodeCompletionHandler回调不执行

核心原因 #

• 定位权限缺失：地理编码功能依赖系统定位权限，若未提前申请权限或用户拒绝授权，CLGeocoder会直接终止请求且可能不触发回调，NullIsland报错就是权限异常时系统返回0,0坐标的典型表现。
• CLGeocoder生命周期异常：如果geocoder属性被weak修饰，或者被提前释放，异步请求的回调会直接丢失，不会执行。
• 异步逻辑顺序错误：当前代码在发起地理编码请求后立刻执行存库、页面跳转逻辑，页面跳转后当前视图控制器如果被销毁，geocoder实例也会被回收，回调自然不会触发，同时存入数据库的location也无法拿到经纬度结果。
• 地址字符串无效：如果拼接的addressString为空或者格式完全不符合地理编码要求，CLGeocoder也可能不触发回调。

解决方案 #

1. 补全定位权限申请逻辑 #

首先在Info.plist中添加定位权限描述字段，比如NSLocationWhenInUseUsageDescription，值填写展示给用户的权限申请理由。然后在发起地理编码请求前，先调用CLLocationManager检查权限，如果权限未确定就先发起授权申请，拿到授权后再执行地理编码逻辑。
参考代码：

let locationManager = CLLocationManager()
locationManager.requestWhenInUseAuthorization()
// 等待权限回调确认是授权状态后再执行地理编码

2. 确认geocoder的持有方式 #

确认类中的geocoder属性是强引用，不要加weak修饰，声明方式参考：

class YourViewController: UIViewController {
    let geocoder = CLGeocoder() // 正确的强引用声明
    // 禁止写 weak let geocoder = CLGeocoder()，会导致实例被提前释放
}

3. 调整异步逻辑顺序 #

把存库、页面跳转的逻辑全部移到地理编码的回调内部，保证只有拿到地理编码结果后，再执行后续操作，同时避免视图控制器提前被销毁。修改后的代码参考：

@objc func addLocationTouchUpInside() {
    // 用默认值避免空字符串强制解包崩溃
    let addressString = "\(streetAddressField.text ?? ""), \(cityField.text ?? ""), \(stateField.text ?? "")"
    // 打印地址确认有效性
    print("待编码地址：\(addressString)")
    var location = Location(id: Location.setid(), locationName: nil, addressString: addressString, latitude: nil, longitude: nil, HoHid: nil)
    geocoder.geocodeAddressString(location.addressString) { placemark, error in
        print("回调触发")
        if let error = error {
            print("编码错误: \(error)")
            // 此处可增加用户侧错误提示
            return
        }
        if let placemark = placemark?.first, let addresslocation = placemark.location {
            location.latitude = addresslocation.coordinate.latitude
            location.longitude = addresslocation.coordinate.longitude
        }
        print("获取到的经纬度：\(location.latitude ?? 0), \(location.longitude ?? 0)")
        // 所有后续逻辑移到回调内执行
        do {
            try AppDatabase.shared.dbwriter.write({ db in
                try location.insert(db)
            })
            self.currentUser?.locationid = location.id
            try AppDatabase.shared.dbwriter.write({ db in
                if var user = try User.fetchOne(db, key: self.currentUser?.id) {
                    user = self.currentUser!
                    try user.update(db)
                }
            })
            let locationInputViewController = LocationInputViewController()
            locationInputViewController.setUser(user: self.currentUser!) 
            locationInputViewController.setLocation(location: location)
            locationInputViewController.setHoH() 
            if let navigationController = self.navigationController {
               navigationController.pushViewController(locationInputViewController, animated: true)
            }
        } catch {
            fatalError("\(error)")
        }
    }
}

4. 避免请求超限 #

苹果对CLGeocoder的请求频率有限制，如果短时间内发起多个请求，可能会被限流导致无回调，建议每次只发起一个请求，前一个请求返回后再发起下一个。

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