微信内直接Scheme跳转必失败，需用腾讯地图Web API+超时检测+用户引导降级链路：先尝试唤起腾讯地图，2秒无响应则提示用户右上角打开并跳网页版导航，最后兜底展示地址文本。
微信内置浏览器（X5内核）和部分安卓 WebView 会主动拦截 window.location.href 触发的第三方 App Scheme 跳转，这不是代码写错了，而是浏览器策略强制限制。直接唤起高德、百度、腾讯地图等 App 在 H5 环境下大概率失败，必须组合降级策略 + 用户引导 + 安全兜底。
微信环境跳转失败的典型表现
点击导航按钮后页面无反应、控制台无报错、window.location.href 赋值后瞬间被忽略；用 setTimeout 检测跳转是否生效时发现 document.hidden 始终为 false，说明跳转根本没触发。
常见错误写法：
const url = 'amap://navi?lat=39.9&lon=116.3'; window.location.href = url; // ✘ 微信内几乎必失败
原因：X5 内核默认屏蔽所有非白名单 Scheme（如 weixin://、qq://），且不提供用户授权弹窗。
必须配合超时检测的 Scheme 跳转
不能只写一次 window.location.href，必须用 setTimeout 监测跳转是否成功，并在失败时降级到网页版或应用市场。
- 高德地图 Scheme 示例（注意 URL 编码和参数顺序）：
androidamap://navi?sourceApplication=uniapp&poiname=%E7%9B%AE%E7%9A%84%E5%9C%B0&lat=39.9042&lon=116.4074&dev=0&style=2 - 百度地图 Scheme 示例：
bdapp://map/direction?destination=%E7%9B%AE%E7%9A%84%E5%9C%B0&coord_type=gcj02&mode=driving&src=uniapp - 超时检测逻辑必须在跳转后 1500–2000ms 内执行，太短可能误判，太长影响体验
- 检测条件优先用
document.hidden === false（页面仍在前台），而非监听visibilitychange，后者在微信里不可靠
微信内唯一稳定方案：用腾讯地图 Web API
微信对自家生态有特殊放行，https://apis.map.qq.com/uri/v1/route/navi 可直接在微信内唤起腾讯地图 App，无需额外配置，成功率接近 100%。
示例调用：
const url = `https://apis.map.qq.com/uri/v1/route/navi?to=latlng:${lat},${lng};name:${encodeURIComponent(name)}&policy=1`;
window.open(url, '_self'); // 注意用 window.open 并指定 _self，比 location.href 更可靠
关键点：
- 必须使用
https协议，HTTP 会被拒绝 -
policy=1表示驾车，可选2（公交）、3（步行） - 域名
apis.map.qq.com已在微信安全域名白名单中，无需开发者额外配置 - 若用户未安装腾讯地图，会自动 fallback 到腾讯地图 H5 导航页
用户引导与降级链路不能省略
纯技术方案无法覆盖所有场景（如用户禁用 URL Scheme、系统版本过低），必须设计完整的用户路径：
- 第一步：尝试 Scheme 跳转 + 腾讯地图 API（并行或按优先级）
- 第二步：2s 内未跳转，则弹出
uni.showModal提示：“请在右上角选择「在浏览器中打开」，再点击导航” - 第三步：用户点击确认后，跳转至高德/百度网页版导航链接：
//uri.amap.com/navigation?to=${lon},${lat},${name}&mode=car - 第四步：若网页版也失效（如 iOS Safari 强制跳 App Store），则展示地址文本 + 复制按钮，供用户手动粘贴到地图 App 中
最易被忽略的是：微信内跳转失败后，**不能静默 fallback 到网页版**，必须明确告知用户当前所处环境限制，并给出可操作动作——否则用户会认为功能“坏了”。
