Vue 3 请求拦截器实现弱网智能降级，核心是前置网络质量判断：通过 useNetworkStatus() 响应式获取 effectiveType，拦截器中动态调整超时、禁用重试、切换精简接口、降级请求头，并同步 UI 状态与日志；不支持 navigator.connection 时回退至耗时统计+手动开关兜底。
Vue 3 中请求拦截器实现弱网智能降级，关键不是“等请求失败再补救”，而是把网络质量判断前置到请求发出前，并结合 Axios 拦截器统一干预行为。它需要和 navigator.connection.effectiveType 监听联动，同时兼容不可靠环境，形成可落地的闭环策略。
在请求拦截器中读取实时网络等级
不要在每个请求里重复判断，而是在请求拦截器（request interceptor）中统一获取当前网络状态：
- 提前封装一个响应式网络状态 Hook（如
useNetworkStatus()），用ref管理effectiveType和映射后的语义等级（如'weak'/'good'） - 在请求拦截器中直接读取该 ref 值，避免异步等待或重复计算
- 若值为
'slow-2g'、'2g'或'3g'，标记本次请求为“弱网上下文”
按网络等级动态调整请求参数
同一接口在不同网络下应有不同“待遇”，拦截器是执行这类策略的理想位置：
vue-component-analyzer
下载
递归分析 Vue 项目组件依赖，从入口文件生成组件层级图，支持 Vue 2/3，输出组件名、文件路径和属性。适用于分析组件结构、排查依赖或了解项目架构。
- 超时时间拉长：弱网下设
timeout: 12000，避免因延迟误判为失败 - 禁用重试：弱网重试成功率低，且易加剧拥塞，设
retryCount: 0 - 切换精简接口：自动将
/api/order/detail改为/api/order/basic（需后端配合版本路由） - 降级请求头：例如移除
X-Need-Full-Data: true类标识，告诉后端返回最小必要字段
触发轻量级 UI 降级与状态同步
拦截器不直接操作 DOM，但可通知上层做出响应：
立即学习“前端免费学习笔记（深入）”；
- 通过 Pinia store 更新全局
isInWeakNetwork状态，供布局组件监听并显示内嵌提示横幅 - 对特定类型请求（如图片资源、非首屏列表），在拦截器中直接
return Promise.reject(...)并附带降级原因，让业务层决定是否 fallback 到占位图或空数据 - 记录弱网请求日志（如请求路径 + effectiveType），用于后续分析真实弱网分布
兜底兼容：当 navigator.connection 不可用时
不能假设所有浏览器都支持 navigator.connection，拦截器必须有 fallback 逻辑：
- 先检查
'connection' in navigator，不支持则跳过 effectiveType 判断 - 退回到基于请求耗时的简易判定：若最近 3 次同类请求平均耗时 > 3s，临时标记为弱网上下文（仅本次请求生效）
- 始终保留手动开关（如 localStorage 中的
forceWeakNetworkMode），便于测试和用户主动启用省流模式
