不能只靠uni.getLocation轮询判断是否进围栏,必须用微信原生onLocationChange+startLocationUpdateBackground组合监听后台位置变化,并用射线法或高德SDK做点在多边形内判定——否则iOS后台失效、Android耗电爆炸、审核大概率被拒。

直接说结论:不能只靠 uni.getLocation 轮询判断是否进围栏,必须用微信原生的 onLocationChange + startLocationUpdateBackground 组合监听后台位置变化,再用射线法或高德 SDK 做点在多边形内判定——否则 iOS 后台失效、Android 耗电爆炸、审核大概率被拒。
为什么 setInterval + uni.getLocation 在后台完全不可行
微信小程序从基础库 2.25.0 起,setInterval 调用 uni.getLocation 在后台会被系统强制暂停,真机上根本拿不到数据;即使前台轮询,每秒一次也会快速触发系统省电策略,定位延迟飙升,且小程序审核明确禁止“非用户主动触发的高频定位”。
- 现象:iOS 上切后台 1 分钟后
uni.getLocation直接返回fail: system error;Android 部分机型(如华为 EMUI)会弹“XX 小程序正在后台持续定位”提示,用户一拒绝就彻底断联 - 真实场景中,高校早八点考勤高峰要求“人一进教学楼就自动打卡”,轮询响应慢 + 后台失活 = 大量漏签
- uni-app 的
uni.getLocation是封装层,无法绕过微信底层限制,别试图用watchEffect或onShow拦截补救
必须配置 requiredPrivateInfos 才能启用后台定位监听
漏掉这个配置,uni.onLocationChange 注册了也永远不会回调——控制台无报错,静默失败,是线上最常踩的坑。
- 在
manifest.json的mp-weixin节点下,显式声明:"requiredPrivateInfos": ["onLocationChange", "startLocationUpdateBackground"] -
permission中scope.userLocationBackground的desc必须单独写,例如:“用于在后台持续监测您是否进入教室区域,保障考勤及时性”,不能复用前台定位的描述 - HBuilderX 开发者工具需关闭「调试基础库自动降级」,真机测试前务必确认微信右上角版本号 ≥ 2.25.0
坐标系必须统一为 GCJ02,WGS84 直接传会偏差 500 米
微信 uni.getLocation 默认返回 WGS84,但高德/腾讯地图所有围栏判断 API(如 AMap.GeometryUtil.isPointInPolygon)只认 GCJ02。混用等于蒙眼算距离。
- 小程序端:调用
uni.getLocation({ type: 'gcj02' }),HBuilderX CLI 版本必须 ≥ 3.9.12,旧版会忽略该参数 - 后端存的围栏多边形顶点坐标也得是 GCJ02——如果来自测绘部门或手动绘制,确认导出时已做坐标系转换,别直接扔 WGS84 数据进去
- H5 端不支持
type: 'gcj02',必须用高德 JS API 的AMap.Geolocation插件获取定位,否则坐标系错位 - 别自己写射线法判断点在多边形内:高德 SDK 的
isPointInPolygon已适配 GCJ02 下的投影变形,手写容易在边缘区域误判
首次定位后别立刻判断,防抖 + 速度校验是防作弊关键
单纯看“是否在围栏内”太脆弱:虚拟定位软件能伪造任意坐标,学生关 GPS 开 WiFi 定位也能漂移进围栏。必须叠加行为逻辑。
- 用
uni.onLocationChange拿到连续坐标流后,先计算两次定位间的移动速度:distance / timeDiff,超过 30km/h 直接丢弃(步行/骑行不可能这么快) - 加 1 秒防抖:同一围栏内连续 3 次判定为“在内”才触发打卡,避免 GPS 跳变导致误打卡
- 服务端必须校验设备唯一标识(如微信
openId+ 手机uuid组合),同一设备 5 分钟内重复打卡只记一次 - 高校实测发现,教学楼室内 GPS 漂移严重,建议围栏半径设为 150 米左右——太小(如 20 米)受漂移影响大,太大(如 500 米)失去考勤意义
真正难的不是代码怎么写,而是围栏数据怎么来、谁来维护、怎么应对教学楼加装金属隔断后信号突变——这些没法靠 onLocationChange 解决,得靠运营机制兜底。


















