jQuery Ajax模块化改造后出现同步XHR弃用警告、$.get不是函数错误的排查解决
报错触发原因
- 核心根因是全局jQuery引用
$被意外覆盖:你的依赖加载链路里jQuery是最先引入的,原本$是全局挂载的jQuery对象。但自定义JS执行过程中,如果某段逻辑意外把全局$赋值为其他非jQuery变量(比如局部变量提升、第三方代码重写全局$、代码书写错误把$当成普通变量重新赋值),就会出现首次触发时引用还未被覆盖、请求能正常发起的情况;同步XHR警告往往是因为错误覆盖发生在首次请求的回调执行阶段,等第二次触发handler时,$已经不再指向jQuery实例,自然会抛出$.get is not a function的错误。 - 同步XHR废弃警告的来源和原生
$.get本身无关:jQuery原生的$.get默认是异步请求,出现这个警告只有两种可能:要么是代码执行链路中意外调用了$.ajaxSetup({async: false}),把全局AJAX配置改成了同步;要么是全局$被覆盖后,调用的$.get其实是其他第三方库实现的同步请求方法,并非jQuery的异步GET。 - 模块化改造时的变量作用域漏洞:你改造后的
handler函数硬编码获取全局url变量,但如果url原本是在点击事件的局部作用域中定义的,handler定义在全局作用域下根本无法取到正确的url值,会触发错误的请求参数,进一步引发连锁异常。
优化调整方案
- 隔离jQuery引用,避免全局
$被覆盖:把所有自定义业务逻辑用无冲突模式包裹,固定传入jQuery实例作为局部$的引用,从根源上避免外部代码对$的修改影响业务逻辑:// 无冲突包裹,固定jQuery引用 (function ($) { // 所有自定义逻辑全部放在这个作用域内 $('#selector').on('click', function () { if (isTrue) { if (isTrue) { // 原有空分支逻辑 } else { handler(objects); } } else { handler(objects); } }); function handler(objects) { // 从传入的对象中取url参数,不依赖全局变量 callAjax(objects.url, function () { // 原有回调逻辑 }); } function callAjax(url, callback) { // 增加引用校验,快速定位问题 if (typeof $.get !== 'function') { console.error('jQuery引用异常', $); return; } $.get(url, function (data) { callback(); }); } })(jQuery); - 简化冗余的嵌套分支:你现在的逻辑里两个非空分支最终都是调用
handler,中间夹了一个永远为空的if判断,完全可以简化掉重复的调用代码,比如将原嵌套逻辑等价转换为:$('#selector').on('click', function () { // 原逻辑等价于:只有最外层isTrue为true、且内层isTrue为true时不执行handler,其余情况都执行 const shouldRunHandler = !(isTrue && isTrue); if (shouldRunHandler) { handler(objects); } }); - 排查全局AJAX配置:全局搜索代码中是否存在
async: false的配置项,尤其是$.ajaxSetup的全局配置,只要将这类同步配置删除,就能彻底消除主线程同步XHR的废弃警告。 - 梳理变量作用域:所有需要在
handler中使用的参数(比如url、业务对象),全部通过函数入参传入,不要依赖全局作用域的变量取值,避免因为作用域隔离取不到正确值的问题。
内容的提问来源于stack exchange,提问作者garyshackle
相关产品推荐
相关产品推荐

