You need to enable JavaScript to run this app. jQuery Ajax中fail函数触发时机及「请求发送期间」含义与示例
优惠活动
大模型
产品
解决方案
定价
更多

jQuery Ajax中fail函数触发时机及「请求发送期间」含义与示例

1. 「请求发送期间」的含义与示例

这里提到的「请求发送期间」,并不是单指把HTTP请求报文推送到公网链路的那一瞬间动作,而是覆盖从$.ajax()方法被调用开始,到浏览器完全接收对应响应、准备触发回调逻辑的全链路周期。这个区间包含了浏览器构造XHR/fetch实例、解析目标域名IP、建立TCP/TLS连接、传输请求报文、后端服务处理、回传响应报文、前端解析响应内容的所有环节,不存在狭义的“仅算网络传输段”的划分边界。

举个直观的边界说明示例:

// 调用方法的这一刻,就已经正式进入「请求发送期间」
const pendingReq = $.ajax({
  url: '/api/article-list',
  method: 'GET',
  dataType: 'json'
})
// 后续从域名解析、TCP建连、把请求发给后端、等后端算完返回结果、浏览器收完响应的全过程,都属于这个区间
// 直到浏览器完成响应内容解析、准备调用done/fail回调的前一刻,这个区间才正式结束

哪怕错误发生在最开始的浏览器构造请求阶段,也算在「请求发送期间」的覆盖范围内。

2. fail回调的全触发场景

只要在上面提到的全周期内出现任意不符合成功判定规则的问题,fail就会被触发,具体覆盖的常见场景包括:

  • 网络链路中断:比如请求传输过程中设备断网、用户切换Wi-Fi/移动网络、运营商链路丢包,导致浏览器无法拿到完整的响应报文
  • HTTP状态码不符合成功判定规则:默认jQuery会将2xx区间状态码、304状态码判定为请求成功,其余状态码(比如403权限不足、404接口不存在、500服务端内部错误、502网关错误)只要后端正常返回了响应,都会触发fail。这个成功判定的阈值可以通过converters、statusCode配置自定义
  • 响应内容解析失败:哪怕后端返回了200的成功状态码,如果响应内容和你配置的dataType不匹配,解析过程抛错的话依然会触发fail。比如你配置了dataType: 'json',但后端实际返回的是纯文本的报错页面,JS层尝试把内容转成合法JSON时抛错,就会走fail分支
  • 请求被主动中止:如果你手动调用之前拿到的jqXHR对象的.abort()方法,主动中断还未完成的请求,fail也会被触发,这时候回调收到的错误标识会是'abort'
  • 请求超时:如果配置了timeout参数,整个全周期的耗时超过了设定的阈值,浏览器主动中断请求,fail会被触发,对应错误标识是'timeout'
  • 跨域请求被浏览器拦截:没有配置合规CORS规则的跨域响应,会被浏览器安全策略直接拦截,JS层拿不到任何响应细节,这种情况同样会触发fail

内容的提问来源于stack exchange,提问作者fahmi derbali

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.31 15:36:08