求助:Uncaught TypeError: $.ajax is not a function错误排查与解决
解决Uncaught TypeError: $.ajax is not a function的常见方案
这种$.ajax is not a function的报错我碰过好多次,大概率是jQuery的引用或环境出了问题——哪怕你之前代码运行正常,环境或者引用细节的微小变化都可能触发这个问题。结合你已经做的排查,我给你补充几个针对性的排查和修复方向:
检查jQuery的
$控制权是否被覆盖
有时候你可能引入了多个版本的jQuery,或者用了$.noConflict()主动释放了$的控制权,这时候$就不再指向jQuery了。你可以在浏览器控制台里输入console.log($)和console.log(jQuery)验证:- 如果
$是undefined但jQuery存在,那就是noConflict的问题,把$.ajax改成jQuery.ajax即可,或者用jQuery的就绪函数重新绑定$:jQuery(function($) { // 这个回调里可以正常用$调用ajax $.ajax({ // 你的ajax配置 }); }); - 如果两者都是
undefined,那说明jQuery根本没加载成功,再仔细检查引用路径:比如是不是用了相对路径但页面层级变更了,或者CDN链接失效了。
- 如果
确认引入的是完整版jQuery
很多人会不小心用了精简版的jQuery(比如jquery.slim.min.js),这种版本会移除ajax、动画等非核心模块,自然找不到$.ajax。去查看你的script引用标签,如果是类似下面的精简版:<script src="https://code.jquery.com/jquery-3.6.0.slim.min.js"></script>替换成完整版即可:
<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>排查其他JS库的冲突
像Prototype、MooTools这类老库也会把$作为全局变量,如果它们在jQuery之后加载,会直接覆盖$的指向。解决办法要么调整加载顺序(让jQuery最后加载),要么用上面提到的noConflict包裹代码。再核对代码执行时机
你提到代码在window.onload后加载,但如果你的jQuery引用加了async属性,window.onload触发时jQuery可能还没加载完成。试试把ajax代码放到jQuery的就绪函数里,确保代码在jQuery准备好后执行:$(document).ready(function() { // 你的ajax逻辑放在这里 });或者更简洁的写法:
$(function() { // 这里的代码会在jQuery加载完成后自动执行 });
内容的提问来源于stack exchange,提问作者robert
相关产品推荐
相关产品推荐

