uni.getLocation 崩溃主因是未处理失败回调导致空值访问，需根据 errCode 1505004/1505003 分别检查安卓权限声明、iOS info.plist 描述字段及 H5 HTTPS 与触发时机。
uni.getLocation 调用后 App 崩溃，先看 errCode 1505004 和 1505003
崩溃往往不是真“崩”，而是 uni.getLocation 失败后没做兜底，上层逻辑直接访问 res.latitude 导致 JS 报错、原生桥接异常，最终触发闪退。真机日志里常见 errCode: 1505004（应用定位权限未开启）或 1505003（系统定位服务未开启），但开发者只看到白屏或进程退出，误以为是原生崩溃。
关键点在于：Android 6.0+ 和 iOS 对权限拒绝的响应方式不同。Android 连续拒绝两次后，uni.authorize 不再弹窗，uni.getLocation 直接进 fail 回调且不抛 JS 异常；而 iOS 若未在 info.plist 配 NSLocationWhenInUseUsageDescription，连 fail 都不会触发，直接静默失败——此时若代码强行读 res，就可能因 undefined 访问引发桥接层 crash。
- 必须在
fail回调里判断err.errCode，而不是只靠console.log(err)看字符串 - 所有对
res.latitude/res.longitude的使用，前面加if (res && res.latitude)守卫 - 不要在
success里直接调用未做空值检查的业务函数，比如showMap(res)应先校验res
Android 12+（API 31）没声明 coarse/fine 权限会静默崩溃
从 Android 12 开始，即使你在 manifest.json 里写了 ACCESS_FINE_LOCATION，如果没在 AndroidManifest.xml 的 <uses-permission></uses-permission> 标签中显式声明，或者没在运行时通过 uni.getSetting + uni.openSetting 引导用户手动开启，uni.getLocation 会直接返回 errCode: 1505004，部分 OEM 系统（如 MIUI 14、ColorOS 13）甚至会杀掉当前 Activity 导致视觉上“闪退”。
这不是 uni-app 的 bug，是 Android 系统级限制。云打包时，DCloud 会自动注入权限声明；但离线打包或自定义原生插件时，容易漏掉 ACCESS_COARSE_LOCATION ——注意，高德 SDK 在无 GPS 信号时会 fallback 到基站/WiFi 定位，必须同时申请这两个权限。
- 检查
manifest.json中app-plus → distribute → android → permissions是否包含两条：<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"></uses-permission>和<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"></uses-permission> - 真机测试务必用 Android 12+ 设备，低版本无法暴露该问题
- 不要依赖
uni.authorize({scope: 'scope.userLocation'})自动弹窗——它在 Android 上基本失效，必须走uni.getSetting检查后跳uni.openSetting
iOS info.plist 缺失描述字段导致启动即 crash
iOS 端最隐蔽的崩溃点：没在 info.plist 里配 NSLocationWhenInUseUsageDescription。Xcode 打包时不会报错，但 App 启动后首次调用 uni.getLocation，系统发现无描述字段，直接终止定位请求，原生层返回空指针，JS 层收不到任何回调——如果代码在页面 onLoad 就调用且没设 timeout，界面会长时间白屏，部分 iOS 版本还会触发 watchdog 终止进程，表现为“打开就闪退”。
这个字段不是可选项，是硬性要求。即使你用的是高德 SDK，iOS 依然要过系统这一关；而且字段值不能为空字符串，必须是中文描述（如“用于显示附近门店”），否则审核会被拒。
- 路径：HBuilderX 工程 →
nativeplugins/ios/Info.plist（云打包）或 Xcode 工程 →Info.plist（离线打包） - 必须添加键：
NSLocationWhenInUseUsageDescription，类型 String，值为非空中文字符串 - 不要写成
NSLocationAlwaysAndWhenInUseUsageDescription——除非你真需要后台定位，否则多申请权限反而提高被拒风险
H5 端 HTTPS 缺失或触发时机不对引发白屏
H5 在线上环境（非 localhost）调用 uni.getLocation，Chrome 和 Safari 都强制要求 HTTPS。若部署在 HTTP 域名下，浏览器会直接拒绝 navigator.geolocation 接口，fail 回调里 err.errMsg 可能是 "getLocation:fail GeolocationPositionError { code: 1 }"，但更常见的是整个页面卡死——因为很多开发者把定位逻辑写在 onLoad 里，没做超时控制，用户看不到提示，只觉得“打不开”。
另一个坑是触发时机：Safari 要求用户手势（click/tap）后才能调用定位，mounted 或 onShow 自动触发会静默失败。微信内嵌 H5 还需额外处理 JSSDK 签名，否则 getLocation 会返回空对象。
- 上线前必须确认域名已配置 HTTPS，且证书有效（可用 SSL Checker 验证）
- 定位按钮必须是用户真实点击触发，不能由
setTimeout或nextTick模拟 - H5 端不要依赖
uni.getSetting查权限——它在 H5 不生效，改用try/catch包裹uni.getLocation并监听err.errMsg.includes('GeolocationPositionError')
errCode 和系统权限状态——90% 的“崩溃”，其实只是没处理好失败分支。 
