编码不匹配导致Backbone.js在hash含JSON时重复加载URL问题
Backbone.js hash重复加载问题解决方案
根因说明
这个问题是Chrome等现代浏览器对location.hash的默认解码规则和Backbone内部的fragment解码规则不一致导致的:
- 浏览器只会对hash中的部分字符做自动解码,不会解码
%22(双引号)这类特殊字符,所以你从window.location.href中读到的hash是#{%22name%22:%22Viktor%22} - Backbone调用
navigate方法时会对传入的hash做全量decodeURIComponent处理,存储的this.fragment值为#{"name":"Viktor"} - 两者值不相等导致
checkUrl校验不通过,触发重复的路由加载逻辑。
规范解决方案(按推荐优先级排序)
方案1:调整参数编码方式(最推荐,无侵入)
避免直接将JSON字符串放入hash中,先将JSON转为base64编码后再使用,完全规避特殊字符编码不一致的问题:
// 跳转前编码参数 const routeParams = { name: "Viktor" }; const encodedParams = btoa(JSON.stringify(routeParams)); this.navigate(encodedParams); // 路由匹配后解码参数 const decodedParams = JSON.parse(atob(Backbone.history.fragment));
该方案不需要修改Backbone的原生逻辑,兼容所有浏览器,还能缩短hash的长度。
方案2:统一getHash解码逻辑(次推荐,通用修复)
如果必须要在hash中直接放JSON字符串,可以重写Backbone.history.getHash方法,对读取到的hash做一次完整的解码,和Backbone内部的编码规则对齐,比你当前只替换%22的临时方案更全面,能覆盖所有特殊字符场景:
Backbone.history.getHash = function (windowObj) { const href = (windowObj || window).location.href; const hashMatch = href.match(/#(.*)$/); return hashMatch ? decodeURIComponent(hashMatch[1]) : ""; };
方案3:特定场景手动控制路由触发
如果仅个别跳转场景出现该问题,可以在调用navigate时手动关闭自动触发路由的逻辑,自行控制路由执行:
this.navigate('%7B%22name%22%3A%22Viktor%22%7D', { trigger: false }); // 自行执行对应路由逻辑
注意事项
直接在hash中放置JSON属于非常规用法,除了双引号之外,
{、}、:等符号在不同浏览器、不同路由模式下都可能出现编码兼容问题,非必要场景下优先使用query参数、路由参数或者base64编码处理参数。
内容的提问来源于stack exchange,提问作者Viktor
相关产品推荐
相关产品推荐

