Fresh Dio 是一个基于 Dio 的轻量级 HTTP 拦截器,可在 API 请求期间自动刷新令牌。它透明地处理身份验证令牌,确保安全且不间断地访问受保护的端点。通过拦截请求并无缝刷新过期令牌,它减少了样板代码并提升了用户体验。非常适合需要强大认证工作流且设置简单的应用程序。
适合场景
API 调用期间自动刷新令牌
处理过期的JWT令牌
保护经过身份验证的API端点
减少手动令牌管理
提高登录会话持久性
简化身份验证状态处理
主要特点
基于 Dio 构建
透明的令牌刷新
支持 JWT 和类似令牌
所需最小配置
自动拦截请求
处理 401 错误的重试逻辑
适合对象
使用 JWT 认证的应用程序
频繁进行 API 交互的项目
寻求减少认证样板代码的开发者
带有会话管理的移动和Web应用程序
优先考虑干净、可维护的身份验证代码的团队
使用建议
需要与现有的 Dio 设置进行集成
仅限基于令牌的认证流程
可能需要自定义逻辑来处理非标准令牌格式
依赖外部网络可用性进行刷新
不适用于无状态或无令牌的 API
原始 README
以下为关联源码仓库的 README 原文快照,最新内容请访问源码仓库。
Fresh 🍋
A collection of packages for automatic token refresh in Dart and Flutter. Fresh handles refreshing, caching, and attaching authentication tokens transparently so your API calls just work.
Why Fresh?
Token-based authentication seems simple until you handle the edge cases: tokens expire mid-session, multiple requests fail at the same time triggering duplicate refreshes, refresh tokens get revoked, and you need to route users to login when auth is lost. Fresh handles all of this so you don't have to.
No more manual 401 handling scattered across your codebase
No more race conditions when concurrent requests trigger simultaneous refreshes
No more stale tokens causing request failures - expired tokens are refreshed proactively before the request is even sent