uni.navigateto跳转不生效主因是误跳tabbar页、路由未就绪、路径未注册、栈超限或异步冲突；须改用switchtab、加nexttick、检查pages.json、用redirectto或监控栈深。
uni.navigateTo 跳转不生效，大概率不是代码写错了，而是用错了场景或踩了平台限制的坑。 直接换 API 或加一层判断，90% 的问题当场解决。
uni.navigateTo 跳转到 tabBar 页面被拦截
这是最常见、最容易忽略的问题：调用 uni.navigateTo 去跳一个已在 pages.json 的 tabBar.list 里声明的页面（比如 /pages/index/index），控制台会输出警告，跳转静默失败：
[navigation] failed to navigate to /pages/index/index : cannot navigateTo a tabbar page.
原因很明确：微信小程序及所有主流小程序平台（支付宝、百度、字节）都禁止用 navigateTo 进入 tabBar 页面——它只允许 push 普通页，而 tabBar 页必须由 switchTab 触发。
- 检查
pages.json中tabBar.list[*].pagePath列出的所有路径，这些路径都属于 tabBar 页面 - 凡是目标 URL 匹配其中任一
pagePath，必须改用uni.switchTab({ url: 'xxx' }) - 注意：H5 端也遵循该规则，不能靠“H5 没限制”来绕过
uni.navigateTo 报 Cannot read properties of undefined (reading 'push')
这个错误不是路径错，而是路由系统内部未就绪——uni.navigateTo 底层依赖 Vue Router 的 router.push，但在某些时机（如 App.vue onLaunch 阶段、组件 created 未等 $nextTick、或 H5 刷新后首屏立即调用）router 实例还没挂载好，导致取不到 push 方法。
Unified LLM Gateway - One API for 70+ AI models. Route to GPT, Claude, Gemini, Qwen, Deepseek, Grok and more
下载
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
- 不要在
onLaunch或created钩子中直接调用uni.navigateTo，改用$nextTick包裹 - H5 端若使用
browserHistory模式，确保服务器已配置 fallback 到index.html，否则首次访问路径可能 404 导致 router 初始化失败 - 开发工具缓存有时会导致 Vue 实例状态错乱，关掉 HBuilderX / VS Code + 重新运行项目能快速验证是否是缓存问题
跳转后白屏 / 无反应 / 控制台没报错
表面没报错，但页面卡住或空白，通常是因为路径注册或平台兼容性断层：
- 确认目标路径（如
/pages/detail/detail）已完整写入pages.json的pages数组，且大小写、斜杠方向与实际文件路径完全一致（Windows 开发者尤其注意反斜杠） - H5 端调用
uni.switchTab时，目标页必须同时满足两个条件：① 在tabBar.list中；② 在pages数组中注册，缺一不可 - 避免在异步回调里连续多次调用
navigateTo（例如登录成功后立刻跳转，又在 success 回调里再跳一次），容易触发平台防抖或栈竞争，改用Promise.finally或标志位防重
页面栈超限报 page limit exceeded: 10
微信小程序硬性限制页面栈最多 10 层，uni.navigateTo 每次都 push 新页，频繁跳转（尤其嵌套详情页）极易触顶。报错后整个导航链会卡死，后续任何 navigateTo 都无效。
- 优先把「不需要返回」的跳转换成
uni.redirectTo（如列表 → 表单 → 提交成功页） - 对关键路径做栈深监控：
uni.getCurrentPages().length，超过 7 层时主动用uni.navigateBack({ delta: 2 })清理中间页 - 慎用
uni.reLaunch全量重置，它虽能清栈，但会丢失当前页参数和滚动位置，适合退出登录等强重置场景
真正麻烦的从来不是“怎么跳”，而是“该不该跳”和“能不能跳”。多端一致性背后是平台规则的硬约束，绕不开，只能提前识别、分层适配。
