Hash模式下如何通过Vue Router官方方式获取URL查询参数?
路由守卫中hash模式获取URL参数的正确方案
核心失效原因
绝大多数情况下to.query无法正常工作,是参数的位置不符合hash模式的URL规范:
vue-router的hash模式下,只会解析#后面的路径与参数段,如果你把参数写在#之前(也就是传统的HTTP查询串位置),vue-router不会自动识别,自然不会存入to.query。
- 错误参数写法示例:
https://你的域名/?id=123#/user - 正确参数写法示例:
https://你的域名/#/user?id=123
标准实现方式
1. 常规场景(参数在hash段内)
只要参数位置符合上述规范,vue-router本身就支持hash模式下的to.query读取,不需要额外手动解析,全局守卫中直接调用即可:
const router = new VueRouter({ mode: 'hash', routes: [] }) router.beforeEach((to, from, next) => { // 直接正常读取即可,hash模式下原生支持 const urlParams = to.query next() })
如果是路由跳转传参,直接在路由对象的query字段传入,vue-router会自动生成符合规范的hash格式URL:
// 跳转时自动拼接成 #/user?id=123&name=test 格式 this.$router.push({ path: '/user', query: { id: 123, name: 'test' } })
2. 特殊场景(参数在hash段外)
如果遇到第三方强制跳转、参数被放在#前面的情况,不需要手动写正则解析URL,直接调用vue-router内置的parseQuery工具方法即可完成解析:
import VueRouter from 'vue-router' // 从vue-router中导出内置查询解析方法 const { parseQuery } = VueRouter router.beforeEach((to, from, next) => { // 读取hash段内的参数 const hashInnerParams = to.query // 用内置方法解析hash段外的查询串,无需自行实现解析逻辑 const hashOuterParams = parseQuery(window.location.search) // 合并两类参数即可使用 const allParams = { ...hashOuterParams, ...hashInnerParams } next() })
常见排查点
- 确认vue-router版本与Vue版本匹配:Vue2对应vue-router3.x,Vue3对应vue-router4.x,版本不匹配会出现路由对象行为异常
- 不要随意修改vue-router默认的
parseQuery配置项,除非你完全清楚自定义解析逻辑的影响
内容的提问来源于stack exchange,提问作者SatishV
相关产品推荐
相关产品推荐

