如何使用Django rest-auth登录返回的Token完成用户登录并跳转至主页
Django rest-auth Token全流程落地实现方案
在你已经能正常通过登录接口拿到返回Token的基础上,按下面的实操步骤就能跑通完整的身份校验、登录态同步、主页跳转逻辑,没有冗余步骤:
1. 登录成功后的Token存储逻辑
rest-auth登录接口成功后,默认返回的Token字段是key(不是常见的token字段,别取错值),拿到值后立刻做持久化存储,避免页面刷新丢失登录态:
- 优先存在浏览器
localStorage,或者对接前端状态管理的持久化插件(Pinia/Redux+持久化配置) - 存储完成后直接执行主页跳转逻辑
// 登录接口成功回调示例 const loginRes = await callRestAuthLogin(loginParams) // 存储rest-auth返回的token localStorage.setItem('auth_token', loginRes.key) // 跳转系统主页 window.location.href = '/home'
2. 全局请求携带Token完成身份校验
Django rest-auth底层对接的是Django REST Framework原生Token认证模块,要求所有受保护的接口请求必须在请求头携带指定格式的认证信息,漏配就会返回401无权限:
- 给项目用的HTTP客户端(Axios/Fetch)加全局请求拦截器,每次发请求自动从本地取出Token,按要求拼到请求头里
- 严格按照后端要求的格式拼接认证头:
Authorization: Token <你的token值>,注意Token和值之间必须有空格,不要错写成通用的Bearer xxx格式,这是最常见的401报错原因
// Axios 全局请求拦截器示例 axios.interceptors.request.use((config) => { const savedToken = localStorage.getItem('auth_token') if (savedToken) { // 严格匹配rest-auth要求的请求头格式 config.headers.Authorization = `Token ${savedToken}` } return config })
- 配套加全局响应拦截器:如果接口返回401状态码,说明Token失效/非法,立刻清掉本地存的Token,自动跳回登录页,不要让用户停留在无权限的页面
// Axios 全局响应拦截器示例 axios.interceptors.response.use( res => res, err => { if (err.response.status === 401) { localStorage.removeItem('auth_token') window.location.href = '/login' } return Promise.reject(err) } )
3. 入口路由的登录态同步校验
用户直接输入主页地址、或者刷新页面的时候,要做主动校验确认Token有效,避免出现本地存了Token但实际已经失效的情况:
- 在全局路由守卫(Vue Router/React Router)里做前置判断:如果访问的是需要登录权限的页面,先检查本地有没有存Token
- 调用rest-auth自带的
/auth/user/接口(该接口要求携带有效Token才能返回当前登录用户信息)做二次校验:- 接口正常返回用户信息:说明Token有效,放行进入主页
- 接口返回401:说明Token失效,清缓存跳登录页
// Vue Router 全局前置守卫示例 router.beforeEach((to, from, next) => { const hasToken = localStorage.getItem('auth_token') // 配置了需要登录权限的路由,才做校验 if (to.meta.needLogin) { if (!hasToken) { next('/login') return } // 二次校验Token有效性 axios.get('/auth/user/').then(() => { next() }).catch(() => { localStorage.removeItem('auth_token') next('/login') }) } else { next() } })
后端配套校验点(避免联调踩坑)
联调时如果出现带了Token还是401,优先检查下面三个配置:
- 确认
settings.py里的REST_FRAMEWORK配置已经把TokenAuthentication加到默认认证类列表中- 确认项目已经安装
rest_framework.authtoken应用,完成数据库迁移生成Token表- 如果有跨域配置,把
Authorization头加到CORS允许的请求头列表中,避免浏览器自动拦掉自定义请求头
内容的提问来源于stack exchange,提问作者Ashish Neupane
相关产品推荐
相关产品推荐

