微信小程序的实时定位功能，很多人以为只是简单调个接口就能完成，但实际开发中，从权限适配到精度优化，再到后台持续定位，每一步都可能踩坑。这篇文章会像手把手讲课一样，把实时定位从原理到实战拆开揉碎，重点解决那些网上很少说透的细节问题。

一、实时定位的核心：不只是“拿经纬度”

微信小程序定位依赖的是 wx.getLocation 和 wx.startLocationUpdate 两个接口。但很多人忽略了一个关键点：实时定位不等于频繁调 getLocation。前者是“持续监听”，后者是“单次获取”。如果你用 setInterval 每秒调一次 getLocation，不仅耗电、耗流量，还会因为频繁弹窗授权被用户投诉。正确做法是使用 wx.startLocationUpdate（后台模式用 wx.startLocationUpdateBackground），它会自动回调位置变化。

举例说明：假设你要做一个外卖骑手轨迹追踪。如果用 getLocation 轮询，每 5 秒请求一次，用户手机电量会暴跌，而且小程序在切后台后会被微信冻结，轮询直接失效。而 startLocationUpdate 会在系统层面监听 GPS 变化，小程序切到后台后，只要在 app.json 中声明了 requiredBackgroundModes: ['location']，系统会继续上报位置。

二、权限适配：安卓和 iOS 的“隐形坑”

很多开发者发现，同样的代码在 iOS 上能定位，在安卓上却返回“获取定位失败”。问题出在权限请求的时机和弹窗策略上。微信小程序在 wx.authorize 阶段，如果用户拒绝过一次，后续再调用授权会直接进入 fail 回调，而不会再次弹窗。这时候需要引导用户去“设置”页面手动开启。

具体操作步骤：

1. 调用 wx.getSetting 检查 scope.userLocation 是否为 false。
2. 如果为 false，用 wx.showModal 弹窗提示“需要定位权限，是否前往设置？”
3. 用户点击确定后，调用 wx.openSetting 打开设置页。
4. 注意：wx.openSetting 在最新版本基础库中只能由用户点击触发，不能在 onShow 中自动调用，否则会失效。

另外，安卓 10 以上系统还多了一个“仅在使用期间允许”和“始终允许”的选择。如果你需要后台定位，必须在 app.json 中配置 permission 字段，并描述使用定位的理由。例如：“用于记录您的运动轨迹”。否则，即使代码写了后台定位，系统也会拒绝。

三、精度优化：从 100 米到 10 米的差距

默认的 wx.getLocation 返回的经纬度精度在 65 米左右，对于导航或打卡场景完全不够用。你可以通过 highAccuracyExpireTime 和 isHighAccuracy 参数来提升精度。但注意：高精度模式会显著增加功耗和定位耗时。

实际开发中，建议采用“分级策略”：

• 对于签到打卡类：使用高精度模式，但设置超时时间 5 秒，如果 5 秒内未返回高精度结果，则降级为普通精度。
• 对于轨迹记录类：使用普通精度 + 卡尔曼滤波算法（前端做平滑处理），避免频繁上报抖动点。
• 对于地图显示类：直接用普通精度即可，因为地图缩放级别低时，10 米和 50 米的差别肉眼看不出来。

这里分享一个实用技巧：在 wx.onLocationChange 的回调中，计算前后两个点的距离，如果小于 5 米，直接丢弃不上报。这样可以减少无效数据，节省服务器带宽和用户流量。

四、后台定位：微信的“潜规则”

很多开发者在后台定位上摔跟头。微信小程序的后台定位其实分两种：一种是“短暂后台”（比如用户按了 Home 键，但小程序还在内存中），另一种是“真后台”（用户锁屏或切换到其他 App 超过 5 分钟）。

对于“短暂后台”，只要开启了 wx.startLocationUpdateBackground，并且 app.json 中声明了 requiredBackgroundModes，就能持续收到位置回调。但注意：iOS 上如果用户关闭了“后台 App 刷新”，定位会停止。你需要在前端检测到定位停止后，弹窗提示用户开启后台刷新。

对于“真后台”，微信小程序会被系统彻底冻结，此时定位上报会中断。唯一的解决方案是使用 微信运动或蓝牙辅助定位，但这种方法限制较多，不推荐。更好的替代方案是：引导用户使用“小程序浮窗”或“添加到桌面”，这样微信会保留小程序的活跃状态，后台定位时间可以延长到 10 分钟左右。

五、常见错误与调试方法

错误 1：errMsg: "getLocation:fail auth deny"
解决：检查是否在 app.json 中配置了 permission 字段。另外，微信开发者工具中需要手动点击“授权”按钮，不能依赖代码自动授权。

错误 2：iOS 上定位成功，安卓上返回空坐标
解决：安卓要求定位接口必须在 onLoad 或用户点击事件中调用，不能在 onShow 中直接调。另外，检查是否开启了“模拟定位”，部分安卓手机会默认关闭 GPS。

错误 3：后台定位上报频率忽高忽低
解决：微信后台定位的上报频率由系统控制，无法手动设置。你可以在 wx.onLocationChange 中自行做节流，比如每 10 秒上报一次最新位置，忽略中间的回调。

调试技巧：在微信开发者工具中，选择“定位”面板，可以模拟各种精度和错误场景。但要注意：模拟定位的返回数据格式与真机略有差异，比如模拟器不会返回 speed 和 accuracy 字段。最终测试一定要用真机。

六、扩展对比：H5 定位 vs 小程序定位

很多人会问：“为什么不用 H5 的 Geolocation API？” 这里做一个对比：

• H5 定位：依赖浏览器，在 iOS 上需要用户点击后才能触发，且无法后台运行。精度通常较低（WiFi 定位为主）。
• 小程序定位：原生能力，精度更高（GPS + 基站 + WiFi 混合），支持后台持续上报，且可以通过微信的授权体系统一管理权限。

如果你的场景是“用户主动点击打卡”，H5 定位勉强可用。但如果是“实时追踪物流车”，小程序定位是唯一选择。另外，小程序定位返回的数据中，speed 字段在行车场景下非常有用，可以用来判断用户是否在移动，而 H5 定位通常不返回速度值。

七、实战案例：做一个“家人守护”实时位置共享

假设你要做一个让家人互相查看实时位置的小程序，核心逻辑如下：

1. 每个用户开启 wx.startLocationUpdateBackground，并设置 type: 'gcj02'（火星坐标系）。
2. 在 wx.onLocationChange 中，将经纬度上报到云开发数据库，同时记录时间戳。
3. 其他用户通过 wx.getLocation 获取自己的位置，并查询数据库获取家人的最新位置，用 map 组件展示。
4. 注意：数据库查询频率不要超过 1 秒 1 次，否则会触发云开发限流。可以用 WebSocket 实时推送，或者使用云函数定时拉取。

这里有一个容易忽略的点：坐标系的转换。微信返回的是 gcj02 坐标，而高德地图、腾讯地图都是 gcj02，但百度地图是 bd09。如果你要用百度地图展示，需要调用 wx.getLocation 时指定 type: 'wgs84'，然后在前端用算法转成 bd09。否则地图上会出现 500 米以上的偏移。

最后提醒一句：实时定位功能对用户隐私敏感度极高。小程序审核时，如果你的定位用途描述不清晰（比如只写“用于定位”），会被驳回。建议在“用户隐私保护指引”中详细说明：收集位置信息的目的（如位置共享）、使用频率（仅在使用时开启）、是否存储（存储时长不超过 7 天）。这样既能过审，也能让用户放心。