为了在每次请求时检查 access_token
的有效期,并在过期时自动刷新,可以通过以下步骤实现:
1. 解析 JWT Token 获取过期时间
JWT token 的有效期是编码在 token 本身的,你可以通过解析 token 来获取它的到期时间。JWT token 是由三个部分组成的:header
、payload
和 signature
,有效期信息通常在 payload
中。
JWT 的 payload
中有一个 exp
字段,它表示 token 的过期时间(单位为 Unix 时间戳)。前端可以通过解析这个字段来判断 token 是否已经过期。
示例:解析 JWT token 获取过期时间
// 解析 JWT token
function parseJwt(token) {try {const base64Url = token.split('.')[1];const base64 = decodeURIComponent(atob(base64Url).split('').map(function(c) {return '%' + ('00' + c.charCodeAt(0).toString(16)).slice(-2);}).join(''));return JSON.parse(base64);} catch (error) {console.error('Invalid token:', error);return null;}
}
通过 parseJwt
方法,可以从 access_token
中提取 exp
字段(过期时间)。
2. 检查 token 是否过期
在每次发出请求前,检查当前的 access_token
是否即将过期。如果过期,使用 refresh_token
请求新的 access_token
,然后继续发送请求。
检查 token 有效期并自动刷新
// 获取当前时间的 Unix 时间戳
function getCurrentTimestamp() {return Math.floor(Date.now() / 1000);
}// 检查 access_token 是否过期
function isTokenExpired(token) {const tokenData = parseJwt(token);if (!tokenData || !tokenData.exp) {return true; // token 无效或没有过期字段,视为过期}const currentTime = getCurrentTimestamp();return tokenData.exp < currentTime;
}// 刷新 token 的函数
async function refreshToken() {const refresh_token = localStorage.getItem('refresh_token');const response = await fetch('http://localhost:8000/api/token/refresh/', {method: 'POST',headers: {'Content-Type': 'application/json',},body: JSON.stringify({refresh: refresh_token,}),});const data = await response.json();if (response.ok) {// 更新 access_tokenlocalStorage.setItem('access_token', data.access);console.log('Token refreshed');return data.access;} else {console.error('Failed to refresh token:', data);return null; // 失败时返回 null}
}
3. 统一的请求封装
为了让每次请求都经过 token 的有效性检查,可以创建一个封装的请求方法。这个方法在请求前先检查 access_token
是否过期,过期则调用 refreshToken()
获取新的 access_token
,然后重新发起请求。
统一的请求方法
async function apiRequest(url, options = {}) {let token = localStorage.getItem('access_token');// 检查 token 是否过期if (isTokenExpired(token)) {console.log('Access token expired, refreshing token...');token = await refreshToken();if (!token) {console.error('Unable to refresh token, please login again.');// 可以根据需求引导用户重新登录return null;}}// 设置请求头,携带最新的 access_tokenoptions.headers = {...options.headers,'Authorization': `Bearer ${token}`,};// 发送请求const response = await fetch(url, options);// 处理响应if (response.ok) {return await response.json();} else {console.error('Request failed:', response);return null;}
}
4. 使用统一的请求方法
在实际使用中,每次发起 API 请求时,使用封装好的 apiRequest
方法:
// 获取受保护的资源
async function getProtectedData() {const data = await apiRequest('http://localhost:8000/api/protected/', {method: 'GET',});if (data) {console.log('Protected data:', data);} else {console.error('Failed to fetch protected data');}
}
5. 自动刷新 token 的策略
通常情况下,刷新 access_token
的时间可以比它实际过期的时间稍微提前一些,以避免在 token 完全过期后导致请求失败。你可以在检查 token 时,判断它是否接近过期(比如还有5分钟过期),提前刷新 token:
// 设置提前刷新时间,比如提前5分钟
const REFRESH_THRESHOLD = 300; // 300 秒 = 5 分钟function isTokenAboutToExpire(token) {const tokenData = parseJwt(token);if (!tokenData || !tokenData.exp) {return true; // 如果没有有效的 exp 字段,视为即将过期}const currentTime = getCurrentTimestamp();return (tokenData.exp - currentTime) < REFRESH_THRESHOLD;
}
总结
- 解析 JWT Token:通过解析 token 的
exp
字段获取过期时间。 - 检查 token 有效期:在每次请求之前检查 token 是否过期或即将过期。
- 刷新 token:如果 token 过期或即将过期,使用
refresh_token
获取新的access_token
。 - 统一封装请求方法:通过封装一个请求函数,在每次请求时都先检查和刷新 token。
- 提前刷新策略:可以设置在 token 过期前的几分钟内就自动刷新,确保用户体验顺畅。
通过这种方式,前端可以在每次请求时确保使用的是最新的 access_token
,并自动处理 token 的过期和刷新。