vue router的“重叠检测”是指其在push或replace时自动比对目标路由与当前活跃路由（path、query、params全匹配），若一致则抛出navigationduplicated错误以阻止冗余导航，防止重复渲染和状态错乱。

什么是路由重叠检测

Vue Router 的“重叠检测”是指框架在调用 push 或 replace 时，自动比对目标路径与当前活跃路由是否一致。若完全相同（path、query、params 全匹配），则判定为冗余导航，抛出 NavigationDuplicated 错误并中止跳转。这不是 bug，而是设计保护——避免重复渲染、生命周期钩子误触发、状态错乱。

重复点击为何会触发重叠检测

用户连续点击同一菜单项或按钮，常导致多次执行 this.$router.push({ path: '/dashboard' })。即使前一次跳转尚未完成（如组件异步加载、守卫未 resolve），后续调用仍会进入导航流程，并在比对阶段被拦截。

Skill Weave Chains — 技能链路由引擎

开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。

下载

• 组件内未做防抖，点击事件直接触发 push
• 菜单高亮逻辑依赖 $route.path，但点击后未禁用按钮
• 使用命名路由 + params 时，params 引用对象未深比较，导致看似不同实则等价

四类稳定有效的 Patch 方式

不推荐全局 catch 掩盖问题，而应分层防御：

• 应用层节流：封装跳转方法，判断目标路径是否等于 this.$route.fullPath，相等则直接 return
• 路由实例增强：重写 Router.prototype.push，统一 catch Promise rejection 并静默吞掉 NavigationDuplicated 类错误（保留其他异常）
• UI 层反馈：点击后立即置灰按钮或加 loading 状态，视觉阻断重复操作
• 路由守卫兜底：在 beforeEach 中检查 to 和 from 是否全等，是则 next(false) 或 next() 跳过

关键细节不能漏

单纯 catch 错误可能掩盖真实问题：

• 若使用 params 跳转，注意 name 相同但 params 不同也属于合法导航，不应被拦截
• 动态路由参数变化（如 /user/:id → /user/2）不触发重叠，但 query 变化（?tab=1 → ?tab=2）会重新比对
• 使用 replace 替代 push 可规避历史栈堆积，但不解决重叠检测本身