强制刷新应用仅适用于401、500类严重错误或登录态彻底失效等不可恢复场景,需通过状态码、业务字段和连续失败标记精准识别,并在响应拦截器中加防护避免循环刷新;优先采用跳转登录页、错误页重试或静默续期等非刷新方案。

当响应拦截器捕获到严重错误(比如 401 Token 失效、500 服务不可用、或后端返回明确的“需重登”标识)时,强制刷新应用是一种简单直接的兜底策略。但要注意:这不是首选方案,仅适用于无法优雅恢复、状态已不可信、或登录态彻底失效等场景。
判断哪些错误该触发强制刷新
不能一有错误就 reload。重点识别三类信号:
- HTTP 状态码:401(未认证)、403(禁止访问,且无续期可能)、500/502/503(服务端崩溃或网关异常,前端无法修复)
-
业务响应字段:后端统一约定如
{ code: 9999, message: "登录已过期,请重新登录" }或data?.auth?.expired === true - 连续失败标记:同一请求重试 2 次仍失败,且错误类型一致(需配合拦截器重试逻辑)
在响应拦截器中实现刷新逻辑
把刷新动作放在响应拦截器的 error 回调里,但要加防护,避免无限循环:
- 检查是否已在刷新中(用全局标志位或 sessionStorage 标记),防止多次触发
- 排除开发环境(
import.meta.env.DEV),避免调试时误刷 - 不直接调
location.reload(),先清 localStorage / sessionStorage 中的 token 和用户信息,再刷新
示例代码片段:
立即学习“前端免费学习笔记(深入)”;
// src/utils/request.ts
response.interceptors.error((error) => {
const { response } = error;
const isCritical =
response?.status === 401 ||
(response?.data?.code === 9999) ||
[500, 502, 503].includes(response?.status);
if (isCritical && !sessionStorage.getItem('refreshing')) {
sessionStorage.setItem('refreshing', '1');
// 清除敏感状态
localStorage.removeItem('token');
sessionStorage.removeItem('user');
// 强制刷新
location.reload();
}
return Promise.reject(error);
});
比强制刷新更优的替代方案
多数情况下,应优先考虑非刷新路径:
-
401 场景:跳转登录页(
router.push('/login?redirect=' + encodeURIComponent(location.pathname))),而非 reload -
500 类错误:展示友好错误页(如
<errorboundary></errorboundary>),提供“重试”按钮,仅点击后才刷新 - Token 过期但可静默续期:在请求拦截器中拦截 401,用 refresh_token 调用换 token 接口,成功后再重发原请求
配套处理:避免刷新后白屏或路由错乱
如果必须刷新,确保基础体验不崩:
- 入口文件
main.ts中,createApp()前加 try-catch,防止初始化阶段 JS 报错导致空白页 - 路由守卫中设置加载状态,刷新瞬间显示 skeleton 或 loading 徽标
- 在
index.html的加style="opacity: 0",Vue 启动完成后再移除,避免 FOUC


















