微信iOS端禁止非用户手势触发的页面跳转，仅允许在click/touchend等真实事件中执行location.replace()；SPA须用hash模式，JS-SDK接口不可用于任意URL跳转。
微信内置浏览器对 HTML5 页面跳转有明确限制，不是所有跳转方式都有效，尤其在 iOS 微信中更为严格。直接使用 window.location.href 或 location.assign() 在部分场景下会静默失败或触发白屏，且无法通过常规 JS 错误捕获机制感知。
微信 iOS 端禁止非用户手势触发的跳转
这是最常踩的坑：iOS 版微信（尤其是 8.0.30+）完全屏蔽了非用户主动操作（如 click/tap）触发的跳转。哪怕只是 setTimeout 延迟 1ms 后执行 window.location.href = 'https://xxx'，也会被拦截。
- 仅允许在
click、touchend（需满足event.preventDefault()未被提前调用）、input（仅限某些输入后）等真实用户事件回调中执行跳转 -
Promise.then、fetch().then、setTimeout、setInterval回调内跳转均无效 - Android 微信相对宽松，但也不建议依赖——统一按 iOS 规则处理最稳妥
location.replace() 和 location.href 行为差异
两者在微信中表现不同：location.replace() 更大概率成功，而 location.href 容易被判定为“模拟跳转”而拦截；但 replace 会丢弃当前页 history 记录，影响返回逻辑。
- 优先使用
location.replace('https://xxx')替代location.href = 'https://xxx' - 若需保留返回按钮（比如从活动页回商品页），必须确保跳转发生在用户点击瞬间，且中间不能有异步链路
- 不要在 Vue/React 的
mounted或useEffect中直接跳转——这些钩子不属于用户手势上下文
微信 JS-SDK 的 openLocation 和 chooseImage 等接口不等于跳转能力
JS-SDK 提供的 API 是功能调用，不是通用跳转通道。它们本身受权限和配置约束，且不能用于跳转任意 URL。
立即学习“前端免费学习笔记（深入）”；
-
wx.openLocation()只能打开地图，不能跳转网页 -
wx.navigateToMiniProgram()仅限已绑定的合法小程序，且需提前在公众号后台配置business_id - 试图用
config接口绕过跳转限制是无效的——config 只影响 SDK 功能授权，不解除浏览器内核的导航策略
SPA 路由（Vue Router / React Router）在微信中白屏或卡死
Vue Router 的 history 模式在微信中极易因 popstate 或 replaceState 异常导致路由错乱，尤其配合 PWA 或离线缓存时。
- 生产环境强制使用
hash模式（mode: 'hash'），避免history.pushState被拦截或失效 - 禁用
scrollBehavior中的异步逻辑（如await new Promise），否则可能阻塞路由切换 - 微信中
beforeEach钩子里调用next('/xxx')若不在用户手势上下文中，同样会被忽略——建议只做同步判断，跳转交由按钮点击触发
真正难处理的不是“怎么跳”，而是“怎么确认用户真的点了、且跳转没被吞”。iOS 微信不会抛错，也不会触发 onerror，只能靠服务端埋点 + 客户端定时心跳兜底验证。别信“加个延时就没事了”，微信的限制是内核级的，绕不过去。
