React Native新架构iOS定位追踪库：代理方法未触发问题排查

针对你开发React Native新架构iOS定位库遇到的问题，直接给你几个精准排查方向：

1. 确认CLLocationManager的代理与实例持有 #

• 必须用实例变量持有CLLocationManager，不能用局部变量——Swift的ARC会自动回收局部变量，导致代理对象提前销毁，自然收不到回调：

  // 错误示例：局部变量会被释放
  func startWatchLocation() {
      let manager = CLLocationManager()
      manager.delegate = self
      // ...其他配置
  }
  
  // 正确示例：用类的实例变量持有
  class LocationTracker: NSObject, CLLocationManagerDelegate {
      private let locationManager = CLLocationManager()
  
      override init() {
          super.init()
          locationManager.delegate = self // 提前绑定代理，确保实例存活
      }
  
      func startWatchLocation() {
          // 在这里配置并启动定位
      }
  }
  

• 核对代理方法签名完全正确，别写错参数类型或方法名：

  // 正确的回调方法签名
  func locationManager(_ manager: CLLocationManager, didUpdateLocations locations: [CLLocation]) {
      print("定位更新：\(locations.last?.coordinate ?? CLLocationCoordinate2D())")
  }
  
  func locationManager(_ manager: CLLocationManager, didFailWithError error: Error) {
      print("定位出错：\(error)")
  }
  

2. 验证定位权限的实际状态 #

• 别只看模拟器的弹窗设置，代码里要主动检查权限状态，确保真的拿到了权限：

  func startWatchLocation() {
      let status = CLLocationManager.authorizationStatus()
      switch status {
      case .authorizedAlways, .authorizedWhenInUse:
          locationManager.startUpdatingLocation()
      case .notDetermined:
          locationManager.requestAlwaysAuthorization() // 对应你申请的Always权限
      default:
          print("当前无定位权限")
      }
  }
  

• iOS 14+要注意，authorizationStatus()是全局状态，locationManager.status是实例状态，两者要保持一致，避免权限判断遗漏。

3. 检查定位配置参数 #

• 别把精度设得太高、距离过滤设得太大，不然模拟器很难触发更新：

  locationManager.desiredAccuracy = kCLLocationAccuracyBest
  locationManager.distanceFilter = 10.0 // 移动10米才触发更新，模拟器需选动态路径才能触发
  

• 模拟器要选动态定位路径（比如Debug > Location > City Bicycle Ride），选固定位置或None的话，不会触发didUpdateLocations。

4. 后台定位的配置细节 #

• 除了info.plist的权限描述，必须在Xcode项目的Signing & Capabilities里开启Background Modes，勾选Location updates。
• 后台定位还要额外设置：

  locationManager.allowsBackgroundLocationUpdates = true
  

5. 排查RN桥接的生命周期问题 #

• 确保你的Swift定位类被Objective-C桥接代码强引用，不能是临时创建后就销毁的对象——如果桥接层只在调用方法时临时实例化，调用完就释放，代理肯定收不到回调。
• 在startWatchLocation里加打印，确认Objective-C确实调用到了Swift的启动方法，且locationManager.startUpdatingLocation()被执行了。

6. 模拟器的小坑 #

• 直接重启模拟器，有时候模拟器的定位服务会抽风，重启后大概率能恢复正常。
• 确认模拟器iOS版本和项目部署目标一致，避免版本兼容性问题。

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