子应用路由冲突的本质是URL响应权归属问题，需通过activeRule前缀约定、微应用basename适配、沙箱隔离及公共资源路径规范四者协同解决。
子应用路由冲突在 qiankun 中本质是“谁该响应当前 URL”的判定问题。关键不在禁止冲突，而在让主应用精准识别、分发和隔离——靠前缀约定 + 沙箱约束 + 微应用适配三者协同。
一、用 activeRule 严格划分路由管辖权
这是最前置、最有效的隔离手段。主应用通过 activeRule 明确声明每个子应用的生效范围，qiankun 会据此劫持路由并只激活匹配的应用。
- 推荐使用带明确业务语义的路径前缀，如 /app-order、/app-user，避免用模糊路径（如
/或/dashboard）导致重叠 - 支持函数式动态匹配：例如多租户场景可写
activeRule: (loc) => loc.pathname.startsWith('/tenant/') && loc.pathname.split('/')[2] === 'order' - 确保所有子应用的 activeRule 不相交，尤其注意斜杠结尾是否一致（
/app-order和/app-order/在部分配置下可能被区别对待）
二、微应用内部适配 basename，不依赖全局 history
子应用不能假设自己运行在根路径下。必须根据运行环境动态设置路由基址，否则跳转、刷新都会出错。
- React 应用：将
basename设为window.__POWERED_BY_QIANKUN__ ? '/app-order' : '/' - Vue 应用：Vue Router 的
base选项同样需做判断，且建议配合history.mode = 'history'避免 hash 冗余 - 务必在子应用入口文件（如
main.js）中完成判断，不要硬编码，否则本地独立运行和嵌入主应用时行为不一致
三、启用沙箱隔离，切断历史操作干扰
多个子应用若都直接调用 history.pushState，会导致浏览器历史栈混乱，后退时跳转错乱。qiankun 的沙箱能拦截并重定向这些操作。
- 启动时开启严格沙箱：
start({ sandbox: { strictStyleIsolation: true } })（v2.10+ 推荐） - 沙箱会为每个子应用提供独立的
history实例，其pushState/replaceState调用会被映射到主应用统一管理的历史栈中 - 禁用沙箱（
sandbox: false）或降级为 legacy 模式会失去该保护，不建议生产环境使用
四、避免公共资源路径污染，防止路由重定向失败
子应用内静态资源（JS/CSS/图片）若使用绝对路径（如 /static/js/app.js），在非根路径下会 404；更隐蔽的是，某些 UI 库或框架的内部跳转逻辑可能隐式依赖 base 路径，导致路由跳转失败。
- 子应用构建时配置
publicPath（Webpack）或base（Vite），确保资源加载路径与运行时 basename 一致 - 检查子应用是否在代码中硬写了
window.location.href或location.assign，这类操作会绕过沙箱和路由系统，应改用history.push或框架提供的导航方法 - 刷新页面时，确保主应用能根据完整 URL（如
/app-order/list）正确识别并激活对应子应用，这依赖 activeRule 的精确性和子应用自身的 basename 适配
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
