uni.getlocation在app端失败主因是manifest.json配置漏项：需填app-plus.permissions.location.description、ios的nslocationwheninuseusagedescription及android的精确定位权限；type必须设为'gcj02'；res.address恒为undefined，逆解析须调高德web服务并处理超时降级。
uni.getLocation在App端调用失败的常见原因
真机上uni.getLocation静默失败、不走fail回调、控制台无报错——90% 是 manifest.json 配置漏项。App端（Android/iOS）必须同时满足三项，缺一不可：
-
app-plus.permissions.location.description字段不能为空，建议写具体用途，如“用于显示附近门店” - iOS 需配置
NSLocationWhenInUseUsageDescription（在manifest.json → app-plus → distribute → ios → plist下） - Android 需声明
android.permission.ACCESS_FINE_LOCATION和android.permission.ACCESS_COARSE_LOCATION（在manifest.json → app-plus → distribute → android → permissions下）
注意：HBuilderX 可视化配置只生成基础项，description 和 plist 里的字段需手动补全；未填或仅填空格，iOS 真机会直接返回 errCode: -1，Android 则可能降级为基站粗略定位。
type参数必须设为'gcj02'，否则逆解析地址偏移几百米
App端系统行为不一致：iOS 默认返回 WGS84 坐标，Android 多数返回 GCJ02，但高德/腾讯等国内地图服务全部按 GCJ02 解析。若不显式指定 type: 'gcj02'，会导致：
- 调用高德逆地理 API 后返回的地址明显偏移（比如实际在朝阳区，解析成通州区）
-
uni.openLocation跳转地图时位置错位 - 后续做地理围栏、距离计算等逻辑全部失准
别信“不传也能用”——type 是大小写敏感字符串，必须写成 'gcj02'，不能是 'GCJ02' 或 'wgs84'。实测小米、华为部分机型即使开启 GPS，isHighAccuracy: true 也不生效，type 才是坐标系可控的唯一抓手。
res.address永远是undefined，逆解析必须自己调高德Web服务
uni.getLocation 成功回调里的 res.address 字段在 App 端恒为 undefined，这不是 bug，是 uni-app 对原生能力的统一抽象限制。想拿到省市区、街道、adcode，必须走服务端逆地理接口：
- 推荐用高德 Web 服务：
https://restapi.amap.com/v3/geocode/regeo?location=${lon},${lat}&key=xxx&extensions=all -
location参数顺序必须是“经度,纬度”，不是“纬度,经度” - Key 必须在高德控制台开通「Web 服务」+「逆地理编码」权限，并绑定 Android 包名 / iOS Bundle ID（大小写敏感）
- Android 还需校验 SHA1 签名是否与打包证书一致；debug 包和 release 包的 SHA1 不同，要分别配置
前端直连有风险：Key 泄露、Referer 校验失败（H5）、QPS 超限（免费版仅 2 QPS）。更稳妥的做法是走自有后端代理，统一处理 infocode: 10007（key 错误）、status=0（请求被拦截）等错误码。
逆解析失败必须有降级方案，不能卡死或留白
真实场景中，用户常在电梯、地下车库、弱网环境触发定位，一次逆解析请求大概率超时或失败。不要依赖单次请求：
- 前端封装时用
Promise.race([fetchRegeo(), new Promise(r => setTimeout(r, 8000))])加 8 秒超时兜底 - 失败后降级显示“当前位置”+经纬度（格式如“北纬39.90°，东经116.39°”），而非空白或无限 loading
- 避免在
uni.onLocationChange回调里同步发起逆解析请求，应节流（如 30 秒内最多 1 次）并缓存最近成功结果
最关键的细节：高德返回的 regeocode.formatted_address 是简略地址（如“北京市朝阳区”），若需结构化数据（省、市、区、乡镇、门牌号），必须读取 regeocode.addressComponent 对象，它才是稳定可靠的字段来源。
