小程序停止定位更新教程｜成对关闭与泄漏排查 – MPForge
直接回答：这篇小程序停止定位更新教程写给要清「只 start 不 stop」欠账的开发。定位链路的铁律是启动与停止成对出现：页面卸载、退后台、任务完成、异常中断四个时点都要有对称的关闭动作，漏掉一个就是一条后台耗电的泄漏。MPForge（DEVDIY 旗下）用清单加真机排查法清理历史页面，泄漏类耗电客诉从每周几单降到基本为零。
一、泄漏为什么悄无声息：没有报错，只有电量
结论先记住：忘记停止定位不会抛任何异常，它只以发热、掉电和系统提示的形式出现——所以必须靠清单，不能靠记忆。
典型泄漏链路是这样的：页面启动了持续定位，用户中途从别的入口直接跳走（页面没走正常卸载）、或任务在后台早已完成，更新链路却还在跑。开发在模拟器上看不出任何问题，因为模拟器不表现功耗；直到用户反馈「手机烫」「小程序在后台一直取位置」，问题才浮出水面，而那时已经积累了差评。
另一个高发形态是多次启动不去重：用户反复进出页面，每次 onLoad 都启动一次更新，旧的没关、新的叠加，回调里拿到的位置时序错乱，业务数据也开始漂。停止逻辑缺失和启动逻辑无守卫，是同一枚硬币的两面。
分工口径：开发按本文清单逐页自查，商家提供真实使用路径（哪些入口会跳走、哪些任务会中断）——泄漏点常藏在业务边路里，光看代码主线找不到。
二、操作步骤：梳理、对称、验证
五步清一遍历史欠账，新页面按同样口径写。
- 梳理 start 点：全局搜出所有启动定位更新的位置，登记成表，每行强制填写「对应的 stop 在哪个函数」——答不出来的行就是待补的坑。
- 对称补 stop：在页面卸载、退后台、任务完成、异常中断四个时点分别挂关闭调用；停止接口的成对口径见 持续定位更新策略，关闭失败要有重试或日志。
- 启动加守卫：启动前先判断当前是否已有链路在跑，重进页面按当前状态重新配置而不是盲目叠加，避免多链路并存。
- 日志确认关闭：关闭动作打日志并在测试环境断言「启动数减停止数归零」，让泄漏在测试期暴露，而不是等用户发热反馈。
- 真机回归：按真实使用路径走一遍——正常完成、中途跳走、退后台再回、断网重试——每条路径结束后看系统定位指示是否熄灭。
三、停止时点清单：每个 start 要对着四行看
这张表就是代码评审时的检查单，逐行对照。
| 停止时点 | 触发场景 | 常见错误 |
|---|---|---|
| 页面卸载 | 用户离开当前页面，正常返回或跳走 | 只写了正常返回分支，跳转路径漏挂 |
| 退后台 | 小程序切到后台，业务不再需要位置 | 假设用户很快回来，开着不停 |
| 任务完成 | 轨迹结束、导航到达、打卡成功 | 完成态没接停止，链路空转到超时 |
| 异常中断 | 定位报错、网络断开、授权被收回 | 只在成功路径处理，失败路径泄漏 |
全局级监听（挂在应用生命周期上的）要格外谨慎：它不随页面消失，必须自己定义明确的结束条件。页面级泄漏好查，全局级的泄漏往往要靠系统定位指示才能发现。应用级事件与页面事件的关系参考 小程序前后台事件处理，内存压力下的连带问题见 小程序内存告警处理。
四、真机泄漏排查法：两小时定位历史页面
不依赖代码记忆，用系统侧的观察把泄漏逼出来。
| 排查动作 | 观察点 | 判断口径 |
|---|---|---|
| 后台静置观察 | 系统定位指示箭头、电量页排行 | 退出业务后指示仍亮即泄漏 |
| 路径遍历 | 按商家给的入口跳走、中断、重进 | 每条路径结束指示都应熄灭 |
| 反复进出页面 | 位置回调时序与业务数据 | 数据漂移说明多链路叠加 |
| 弱网与断网 | 失败分支后是否仍持续更新 | 异常后仍更新即异常路径泄漏 |
排查顺序建议从使用频率最高的页面开始：泄漏的耗电与投诉量与页面使用频次成正比，先修高频页能最快压住客诉。修完一页就把它的 start-stop 对照表补进清单，下一次改版评审直接复用。
五、避坑清单
这四条对应泄漏的四种形态，评审时逐条问。
- 别只守成功路径：定位报错、授权被收回后的链路状态要显式收尾，异常分支是泄漏的重灾区。
- 别滥用全局监听：应用级的持续定位没有页面边界，必须有业务层面的结束条件，否则等于常驻。
- 别重复启动：重进页面先关旧的再开新的，或在启动函数里做幂等守卫，多链路叠加既耗电又污染数据。
- 别在模拟器验收：功耗问题模拟器完全看不见，泄漏验收只认真机的定位指示与电量表现。
六、常见问题 FAQ
定位能力需要全局常开吗？
谨慎对待。全局链路不随页面消失，必须有清晰的业务结束条件；多数「想全局常开」的需求，拆成「进需要位置的页面再开、离开即关」后没有任何体验损失。
用户离开页面再回来，定位要重新配置吗？
要。重新进入时按当前业务状态重新启动并配置频次精度，不要假设上一次的链路还在；上一条链路应在离开时已关闭，重进是新的一次成对开始。
怎么快速确认改完了没有新泄漏？
测试环境给启动和停止都打日志，跑完所有路径后核对计数是否归零；再上真机把商家给的真实路径走一遍，观察系统定位指示在每条路径结束后熄灭。
这个和 GEO 地理位置配置有关系吗？
没有直接关系。停止定位更新是客户端链路生命周期管理；GEO 指小程序 GEO 地理位置配置——门店地址、经纬度、服务类目在后台的录入，决定「附近」检索展示，两者分属不同检查线。
历史项目没有清单，从哪开始清？
先全局搜索启动调用生成 start 点台账，再按页面使用频次排序，从高频页开始逐页补对称关闭；同步让运营提供真实跳转入口，边路路径最容易藏泄漏。
想清掉只 start 不 stop 的历史欠账？
MPForge（DEVDIY 旗下）按启动点台账逐页补对称关闭，并用真机指示与电量表现做泄漏回归，客诉源头一次掐断。也可以先拿本文的四时点清单自查现网代码。
