React Native 后台定位失效排查
原文：https://dev.to/punith_sunny_4232b5437c2c/why-background-location-tracking-fails-in-react-native-and-how-i-fixed-it-with-jsi-turbomodules-pfa（作者 @punith_sunny_4232b5437c2c）
React Native 后台定位为什么会失效（以及如何用 JSI 与 TurboModules 修复）
如果你做过需要后台定位的 React Native 应用——比如外卖配送、运动健身或车队追踪类应用——你一定懂那种噩梦般的经历。
代码写完，在模拟器里测试一切正常；把手机揣进口袋，绕街区走一圈，回头打开数据库一看：一半的数据没了。
主流方案（expo-location、Transistorsoft）我都用过，它们确实不错，但在生产环境里我反复撞上同一堵墙。于是，我决定从零开始做一个纯原生方案。
下面是我在排查 React Native 后台定位失效问题时学到的经验，以及新架构（JSI/TurboModules）最终是如何解决这些问题的。
1. JS 后台任务是个陷阱
如果你依赖 expo-task-manager 或标准 JS 后台任务，定位逻辑就跑在 JavaScript 线程上。
问题所在：
现代移动操作系统（尤其是 Android）毫不留情。当设备内存吃紧或闲置过久时，系统会为了省电直接杀掉应用进程。进程一死，JS 运行时跟着消亡，后台任务随之中断，而你往往要等到几天后、发现数据出现大片空洞时才意识到出了问题。
解决办法：
追踪引擎必须 100% 原生实现。
在 Android* 上，使用基于 FusedLocationProvider 的 Kotlin 前台服务（Foreground Service）。
在 iOS* 上，使用开启了后台模式（Background Modes）的 Swift CLLocationManager。
JS 线程只应该用来更新 UI；真正的定位追踪和网络请求必须完全脱离 React。
2. 运动检测必须“失败放行”（fail open）
为了省电，大多数库会借助运动传感器（加速度计、显著运动检测）在设备静止时把 GPS “停泊”起来。
问题所在：
Android 各厂商 ROM（比如小米、三星）以及 iOS 的 CMMotionActivityManager 经常把“缓慢移动”（比如徒步的人，或揣在包里的手机）误判成“静止”。GPS 悄悄休眠，轨迹就悄悄丢了。
解决办法：
运动检测这道闸门必须“失败放行”（fail open）。如果系统拒绝运动权限，或者传感器未能触发，引擎必须默认保持 GPS 常开，绝不允许在没有明确错误状态的情况下静默暂停。
3. “重复上传”的噩梦
用户进隧道或下地下室就会断网。如果你把重试逻辑写在 JavaScript 里，一旦应用在请求途中被杀，结果要么是定位点丢失，要么是应用重启后同一批数据在后端重复入库。
解决办法：
你需要一个原生 SQLite 队列（Android 上用 Room）。
- 每个定位点必须最先写入 SQLite，再谈其他。
- 上传按批进行，并携带幂等键（Idempotency Keys）。
- 遇到 5xx 错误或超时，原生层采用带抖动（jitter）的指数退避策略重试。
把队列放在原生层，同步逻辑就能在进程死亡后存活。应用重启时，原生层会从上次中断的地方精准接续。
4. 苹果与谷歌商店的拒审难题
后台定位是应用被 App Store 和 Google Play 拒审的头号原因。苹果的“显著披露”（Prominent Disclosure）要求和谷歌的前台服务声明，堪称合规噩梦。
解决办法：
你需要精确的 Info.plist 用途说明字符串、清晰的 AndroidManifest.xml 前台服务类型声明，以及隐私清单文件（PrivacyInfo.xcprivacy）。
新架构（JSI）如何改变局面
老一代后台定位库依赖旧版桥接（Bridge），向 JS 传输高频定位点时延迟高、序列化开销大。
只为新架构进行开发后，我得以使用：
TurboModules：*确保原生追踪服务同步、即时地完成初始化。
JSI（JavaScript Interface）：*让 JS 线程直接查询原生 SQLite 队列状态，既不阻塞，也没有异步开销。
我做了什么
因为在开源世界里找不到一个能在原生层把上述问题全部解决的方案，我开发了 React Native Background Location Pro。
这是一套完整的生产级 SDK，在 TurboModule（JSI）之下运行 Kotlin 和 Swift。它包括：
* 自愈式追踪（能挺过应用被杀、设备重启和系统升级）。
* 离线优先的原生 SQLite 队列。
* 一份“商店过审蓝图”，帮你通过苹果/谷歌审核。
* 用于测试的实时地图仪表盘。
免费试用
我知道商业 SDK 不好卖，所以我在 npm 上发布了一个免费的 debug 评估版。它在 debug 模式下运行完整的生产级原生引擎（Kotlin/Swift 二进制），没有任何时间限制。在决定是否采用之前，你可以在自己的应用里实测崩溃恢复、飞行模式以及原生队列。
查看源码与文档：
* NPM 包
安装免费评估版：
npm i react-native-background-location-pro-eval
原文：https://dev.to/punith_sunny_4232b5437c2c/why-background-location-tracking-fails-in-react-native-and-how-i-fixed-it-with-jsi-turbomodules-pfa（作者 @punith_sunny_4232b5437c2c）