Access Token、Refresh Token 与登录状态管理

设计短期访问、刷新轮换、退出与失效后的客户端行为

🎯 引言

学完这篇文章,你能安排访问令牌过期后的刷新流程,处理刷新失败、重复刷新和退出登录。

⏱ Access Token 用于访问接口

Access Token,访问令牌,是调用受保护接口时携带的凭据。例如登录后取得有效期为 15 分钟的 Token,请求用户资料时放入请求头:

GET /me HTTP/1.1
Authorization: Bearer <登录后取得的AccessToken>

服务端验证令牌后返回用户资料;凭据无效或过期时返回 401。尖括号内容需要替换为真实登录返回值。令牌可以采用前篇介绍的 JWT,也可以采用服务端查记录的随机凭据。


🔑 Refresh Token 用于延续登录

Refresh Token,刷新令牌,用于换取新的访问令牌。它通常比 Access Token 活得更久,例如 7 天,让用户无需每隔 15 分钟重新输入密码。

Refresh Token 只提交给刷新接口,不跟随每个业务请求发送。浏览器应用可以把它放在 Secure、HttpOnly Cookie 中,减少页面脚本直接读取的机会;Cookie 认证的刷新接口仍要检查请求来源等 CSRF 防护。

有效期应按业务风险设置。访问令牌短期过期与登录会话最终到期是两件事:刷新会话到期后,用户需要重新登录。


🔄 收到 401 后怎样刷新

下面用 /auth/refresh 表示项目的刷新接口,Cookie 中保存刷新凭据。前端在业务请求因访问令牌失效返回 401 后发出:

POST /auth/refresh HTTP/1.1
Cookie: refresh=<当前刷新凭据>

服务端检查刷新记录是否存在、是否到期或撤销。通过后返回新的访问令牌;采用刷新轮换时,还会通过 Set-Cookie 更新刷新凭据。例如响应正文为:

{"accessToken":"新的访问令牌","expiresIn":900}

expiresIn 表示新访问令牌还能使用多少秒。前端保存新值后,用它重试原来的业务请求一次。接入认证服务时,使用该服务约定的刷新地址、凭据传递方式和响应字段。


🗃 保存登录记录,才能让退出生效

假设用户 1 在手机上登录,服务端为这次登录保存一条记录:它属于用户 1、七天后到期、目前没有退出。刷新接口收到凭据后查找这条记录,只有记录有效才发放新的 Access Token。

用户退出时,将这条记录标记为已退出。之后即使再次提交原来的 Refresh Token,刷新接口也返回 401。电脑上的登录可以使用另一条记录,因此退出手机不必同时退出电脑。

记录应保存在数据库等重启后仍能读取的位置。保存刷新凭据时使用摘要,也就是根据凭据计算出的校验值;收到刷新请求时用同样方式计算后查找,避免数据库直接存放可用于登录的原始凭据。


🔁 每次刷新后更换刷新凭据

刷新轮换就是刷新成功后发出新的 Refresh Token,并停止接受旧值。例如第一次提交 R1,服务端返回新的访问令牌,同时通过 Set-Cookie 将 R1 换成 R2;下次刷新只能提交 R2。

这样,已经使用过的 R1 即使被复制,也不能继续换取访问令牌。旧值再次出现时,服务端按认证方案决定是否撤销这次登录并要求重新登录。

如果两个请求同时提交 R1,也只能有一个成功更换凭据。这项检查和更新需要由认证服务一起完成;前端则按下面的方式避免同时刷新。


🖥 多个接口同时过期怎么办

页面可能同时请求资料、消息和权限。它们同时返回 401 时,只发起一次刷新,其他请求等待这一结果。

刷新结果客户端接下来做什么
刷新成功更新 Access Token,原请求分别重试一次
刷新返回 401清理本地登录状态,引导重新登录
刷新网络失败提示连接问题,避免无限自动重试
业务接口返回 403显示无权限,不通过刷新解决

如果刷新成功后原请求仍返回 401,就停止重试,防止形成循环。前端只负责协调请求,不能自行延长服务端令牌的有效期。


🚪 退出要同时处理两端状态

退出接口撤销当前登录的刷新记录,并清除浏览器 Cookie;前端同时清理内存中的访问令牌。之后刷新会返回 401。

已经签发的 JWT 不会因为删除刷新记录就自动失效。如果业务要求退出后立即拒绝旧 Access Token,需要接口额外查询会话撤销状态;否则它可能在自身有效期结束前仍然可用。

修改密码或账号被禁用时,还应按业务要求撤销该用户的其他登录会话,不能只退出当前页面。


❓ 知识问答

Q1:使用 Session 的网站也必须引入两种 Token 吗?

不必。普通 Session 登录可以通过会话有效期管理状态,两种令牌用于需要这类认证流程的项目。

Q2:可以把 Access Token 的过期时间设得很长,省掉刷新吗?

泄露后的可用时间也会变长,应根据风险选择有效期,不能只为减少请求而延长。

Q3:刷新失败就代表密码错了吗?

不一定,也可能是刷新凭据到期、被撤销或重复使用。客户端应按刷新结果决定是否重新登录。


🧪 小练习

画出两个请求同时返回 401 时的处理顺序,标出一次刷新、两次原请求重试,以及刷新失败后的退出位置。

// 请在这里记录处理步骤