Vue 3 通过网络质量与请求反馈双信号预判降级:监听 navigator.connection、Axios 耗时/失败率,Pinia 管理状态;以横幅、图标、折叠区块轻量提示;自动缩短超时、切换接口、降级资源;兼容无 connection API 场景并保留手动开关。

Vue 3 中统一处理服务端降级的友好提示,关键不是等错误发生再“报错”,而是提前感知服务能力变化,并把降级状态转化为用户可理解、不干扰操作的轻量反馈。
用网络质量 + 请求反馈双信号判断降级时机
仅靠接口返回 503 或超时容易滞后,也容易误判。应结合浏览器原生能力与真实请求表现:
- 监听 navigator.connection.effectiveType 变化,将
'slow-2g'、'2g'、'3g'映射为“弱网环境”,触发预降级策略 - 在 Axios 请求拦截器中记录耗时,对连续 2 次请求 > 5s 或失败率 > 30%,主动置为“服务降级中”状态
- 将该状态写入 Pinia store(如
useNetworkStore().isDegraded = true),供全局消费
提示不弹窗,只嵌入上下文
用户不需要知道“服务降级”这个技术词,只需要感知当前体验已做适配:
- 顶部固定横幅(非 modal):显示「网络较慢,内容已精简」+ 右侧关闭按钮(点击后本次隐藏,30 分钟内不再出现)
- 功能入口旁加状态图标:如搜索框右侧显示一个灰色 ? 图标,hover 提示「当前加载模式:基础版」
- 列表页自动折叠非核心区块:评论区、推荐位、图片轮播等,用
v-if="!networkStore.isDegraded"控制,不渲染即不请求
请求层自动适配降级行为
提示只是表层,真正影响体验的是请求逻辑本身:
从零开始编排 SpringBoot+Vue 全栈项目工作流,适用于新建全栈项目或完整脚手架请求,触发后依次调用 product‑spec‑builder(需求调研)等模块。
立即学习“前端免费学习笔记(深入)”;
- 弱网或降级状态下,Axios 默认 timeout 设为 8000ms(而非 15000ms),且禁用重试
- 自动切换接口路径:如
/api/v2/user/profile→/api/v1/user/profile/basic - 资源加载策略同步调整:禁用图片懒加载、高清图强制替换为 1x 占位图、SVG 替换为 PNG
兜底:无 network API 时的兼容方案
部分 Safari / 旧 Firefox 不支持 navigator.connection,需降级处理:
- 先检查
'connection' in navigator,不支持则退回到基于navigator.onLine+ 连续心跳请求(/api/health)耗时统计 - 若心跳超时 3 次,才触发降级;否则默认按“4g”处理,避免误伤
- 始终保留手动开关(如设置页里的「省流模式」),让用户有控制权
不复杂但容易忽略

















