通过拦截器模式实现请求数据预认证策略,核心是在发起网络请求前统一检查本地存储的凭证状态。具体做法是封装一个自定义的 fetchwithauth 函数,在内部先读取 localstorage 中的 token,若存在则自动注入到 authorization 请求头中,随后调用原生 fetch 发送请求。这样做的结果是所有使用该封装函数的请求都会携带认证信息,无需在每个业务逻辑中重复编写鉴权代码。

如何构建通用的带认证 Fetch 封装函数
该封装函数直接回答标题问题,通过创建一个高阶函数或包装器来实现。开发者需要定义一个配置对象,包含基础 URL 和默认 headers,然后在每次调用时合并用户传入的参数。关键步骤是检查认证令牌的有效性,如果令牌过期则触发刷新逻辑或直接拒绝请求。这样做能确保请求数据的预认证策略在应用层得到统一执行。

const API_BASE = 'https://api.example.com';
async function fetchWithAuth(endpoint, options = {}) {
const token = localStorage.getItem('auth_token');
if (!token) {
throw new Error('No authentication token found');
}
const defaultHeaders = {
'Content-Type': 'application/json',
'Authorization': `Bearer ${token}`
};
const config = {
...options,
headers: {
...defaultHeaders,
...options.headers
}
};
try {
const response = await fetch(`${API_BASE}${endpoint}`, config);
if (response.status === 401) {
// Handle token refresh or redirect to login
console.warn('Unauthorized access, refreshing token...');
// Implement token refresh logic here
return null;
}
return response.json();
} catch (error) {
console.error('Fetch error:', error);
throw error;
}
}
上述代码展示了完整的封装逻辑。输入为端点路径和可选的配置项,实际调用时会先获取 token 并组装 headers。预期结果是成功返回 JSON 数据或在 401 错误时触发处理流程。注意这里没有使用全局拦截器,而是通过函数组合实现,适用于大多数现代浏览器环境。
立即学习“Java免费学习笔记(深入)”;
如何处理 Token 失效与自动刷新机制
针对 Token 失效这一常见场景,预认证策略需要包含重试机制。当服务器返回 401 状态码时,不应直接报错,而应尝试获取新的 Access Token。具体做法是调用专门的刷新接口,成功后更新本地存储并重新发起原始请求。这样做能保证用户体验的连续性,避免因短暂的网络波动或 Token 过期导致的中断。

let isRefreshing = false;
const requestsQueue = [];
async function refreshToken() {
const refreshToken = localStorage.getItem('refresh_token');
const response = await fetch('/api/auth/refresh', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ token: refreshToken })
});
if (response.ok) {
const data = await response.json();
localStorage.setItem('auth_token', data.access_token);
localStorage.setItem('refresh_token', data.refresh_token);
return true;
}
return false;
}
async function fetchWithRetry(endpoint, options) {
try {
return await fetchWithAuth(endpoint, options);
} catch (error) {
if (error.response?.status === 401 && !isRefreshing) {
isRefreshing = true;
const success = await refreshToken();
isRefreshing = false;
if (success) {
// Retry the original request with new token
return fetchWithAuth(endpoint, options);
} else {
// Redirect to login or clear session
window.location.href = '/login';
return null;
}
}
throw error;
}
}
这段代码引入了队列管理和刷新锁,防止并发请求导致的多次刷新。输入包括原始请求参数,实际行为是先尝试正常请求,失败后进入刷新流程。预期结果是在 Token 有效时透明地继续执行,无效时重定向用户。这种设计确保了预认证策略的健壮性,同时避免了死循环风险。
基于 localStorage 空值时的具体处理逻辑
当 localStorage 中不存在 auth_token 键时,程序会抛出异常。这是预认证策略的第一道防线,强制要求用户必须先登录才能发起受保护的资源请求。具体表现为 fetchWithAuth 函数在检测到空值时立即终止执行,不会向服务器发送任何请求。这种设计确保了安全性,防止未授权访问。


















