Firefox 84/85下React应用Apollo GraphQL请求报NetworkError问题排查

已锚定的排查前提：

• 问题仅在Firefox 84、85稳定版上异常高发，其他版本无同类错误率抬升
• 已排除CORS配置问题
• 当前采集到的ApolloError结构为{"graphQLErrors":[],"networkError":{},"message":"NetworkError when attempting to fetch resource."}，本地全场景测试无法复现

优先排查的版本专属已知问题 #

这些问题和你描述的“空networkError、本地无法复现、仅特定版本高发”的特征完全匹配：

• Firefox 84引入的Fetch响应静默校验机制：该版本开始，浏览器对跨域Fetch返回的响应做了严格校验，如果响应缺少X-Content-Type-Options: nosniff头、或者返回的Content-Type不符合Apollo要求的application/json规范，浏览器会直接在网络层拦截请求，抛出无任何详情的通用NetworkError，不会将具体拦截原因挂载到错误对象上——这也是你采集到networkError:{}空对象的核心原因。这类校验问题和之前遇到的旧版本请求头不兼容问题不属于同一类，是84版本新加入的逻辑。
• 跨站隐私保护（ETP）的默认拦截：Firefox 84首次将严格版增强型跟踪保护设为全量默认开启，当你的GraphQL请求为跨域发起（前端域和GQL后端域不一致）、且请求未配置合规的跨站Cookie策略（SameSite=None; Secure）时，浏览器会直接在网络层拦截Fetch请求，抛出通用的NetworkError，不会在错误详情中暴露拦截原因。本地测试时，开发环境的Firefox通常会手动放宽ETP权限，因此永远无法触发该类拦截，和你描述的本地无法复现的现象完全吻合。
• 请求中断的错误类型映射偏差：Firefox 84、85调整了Fetch API的错误冒泡逻辑，当Apollo Client 3.4及更早版本遇到路由跳转、组件卸载触发的AbortController.abort()请求中断时，会将原本属于主动中断的AbortError，统一归类为通用Fetch NetworkError，且不会将中断原因挂载到networkError对象上，最终形成空结构的错误对象。

可快速落地的验证方案 #

• 补全埋点维度：在Apollo的自定义Fetch逻辑中，主动捕获Fetch抛出的原始错误，把error.cause、error.name属性全部序列化上报——之前仅采集ApolloError本身的方式，完全丢失了浏览器底层抛出的错误原因，才会看到空的networkError对象。自定义封装示例：

  const customFetch = async (input, init) => {
    try {
      return await fetch(input, init)
    } catch (err) {
      const wrappedError = new Error(err.message)
      // 把底层错误原因全部挂载到错误对象上方便上报
      wrappedError.causeMessage = err.cause?.message
      wrappedError.rawErrorType = err.name
      throw wrappedError
    }
  }
  // 将customFetch传入HttpLink的初始化参数
  

• 验证ETP拦截根因：针对84/85版本的用户，埋点采集当前的第三方Cookie可用性（通过简单的第三方资源加载测试实现）、ETP开启状态，如果该类错误90%以上出现在开启严格ETP策略的用户群体中，即可锁定根因。
• 验证请求中断误判：将Apollo Client升级到3.5及以上版本，该版本专门修复了Abort中断的错误识别逻辑，会将主动中断的请求归类为AbortError而非通用NetworkError，升级后如果该类错误率下降80%以上，即可锁定是请求中断的误报问题。

易踩的排查误区 #

• 无需继续投入精力排查CORS：Firefox 84/85版本触发的真实CORS拦截错误，必然会携带明确的“跨域请求被拦截”类提示信息，和当前无详情的通用NetworkError不属于同一类报错，之前排除CORS问题的判断是准确的。
• 调整本地复现的环境配置：测试复现时必须把Firefox的ETP策略调到最严格级别、手动禁用第三方Cookie权限，才能匹配真实用户的默认浏览器配置，否则永远无法触发对应拦截逻辑。

内容的提问来源于stack exchange，提问作者Ruifeng Ma