React Native iOS端使用@mauron85/react-native-background-geolocation调用start()崩溃问题

核心问题修复步骤 #

• 先临时注释项目内所有调用react-native-geolocation的代码，两个定位库同时抢占iOS系统定位资源是该场景下最常见的崩溃原因，验证崩溃消失后再把所有定位逻辑统一迁移到@mauron85/react-native-background-geolocation即可。
• 调整start方法的调用时机，不要在BackgroundGeolocation.checkStatus()的同步回调内直接调用start，可以加100ms的异步延迟触发，或者将start调用逻辑移到组件完全挂载后的异步生命周期中，部分版本的库在回调资源未释放时调用启动方法会触发原生层野指针崩溃。

配置项排查 #

• 确认Info.plist已经完整配置三项权限描述：NSLocationWhenInUseUsageDescription、NSLocationAlwaysAndWhenInUseUsageDescription、NSMotionUsageDescription，缺少任意一项都会触发启动时无报错直接崩溃。
• 检查初始化配置的locationProvider参数，iOS端必须使用BackgroundGeolocation.DISTANCE_FILTER_PROVIDER，不要使用ACTIVITY_PROVIDER，后者的iOS适配存在未修复的原生bug。

补充排查方案 #

• 打开Xcode的「Devices and Simulators」面板，选择测试设备后点击「View Device Logs」，找到对应应用的崩溃日志，查看原生调用栈的报错信息，可直接定位底层崩溃原因。
• 如果上述方案都无效，可以将@mauron85/react-native-background-geolocation版本降级到0.6.3，该版本是目前iOS端兼容性最稳定的版本，更高版本存在部分RN0.60+适配问题。

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