Fetch API DNS解析失败返回TypeError: failed to fetch是否为预期行为？

错误性质判定 #

你遇到的TypeError: failed to fetch是DNS查询失败场景下的预期返回结果，和resp变量与标准Response对象的类型一致性无关。

按照Fetch API的标准规范，只要请求在网络层无法完成完整的收发流程，包括但不限于DNS解析失败、跨域规则校验不通过、客户端无网络、请求被浏览器安全策略/扩展拦截，都会直接抛出该错误。此时请求还没走到接收服务端响应、生成Response对象的阶段，fetch返回的Promise会直接被reject，不会执行后续的resp赋值逻辑，因此不存在类型不匹配触发错误的可能。

网络错误与普通JS TypeError的区分逻辑 #

你可以通过以下特征快速区分两类错误：

• 错误消息特征：Fetch抛出的网络类错误固定携带failed to fetch的提示文本，普通JS逻辑触发的TypeError会携带明确的代码逻辑提示，比如Cannot read properties of undefined、xxx is not a function等，二者消息特征差异明显。
• 错误触发时机：如果错误在await fetch的等待阶段抛出，且未执行到fetch调用后的同步逻辑，即可确定为Fetch API抛出的网络相关错误。

目前浏览器侧没有向JS层暴露网络错误的细粒度分类能力，你无法直接通过错误对象判断是否为DNS解析失败，只能通过排除法（确认域名格式合法、跨域配置正确、无扩展拦截后）推断具体错误类型。

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