关键在于全局异常处理器统一拦截tokenexpiredexception等jwt异常，返回标准401响应；结合多guard适配中间件、分用户类型刷新接口及前后端状态码协同，实现一次配置、多用户通用的健壮过期处理。
遇到 Laravel JWT 多用户场景下令牌过期报错（如 TokenExpiredException 或 Token has expired），关键不是逐个 try-catch，而是通过全局异常处理 + 中间件拦截 + 统一响应格式，实现“一次配置、多用户通用”的健壮应对。
统一异常处理器拦截过期异常
Laravel 的 App\Exceptions\Handler 是捕获所有未处理异常的入口。JWT 过期异常（如 Tymon\JWTAuth\Exceptions\TokenExpiredException）属于可预期业务异常，应在此处统一转换为标准 JSON 响应，避免堆栈暴露。
- 在
render()方法中判断异常类型，返回一致的 401 状态和结构化消息：
if ($exception instanceof \Tymon\JWTAuth\Exceptions\TokenExpiredException) {
return response()->json([
'success' => false,
'message' => '登录已过期，请刷新访问令牌或重新登录',
'code' => 'token_expired'
], 401);
}
- 同样处理
TokenInvalidException、TokenBlacklistedException等常见 JWT 异常，归类为认证失败类错误，保持前端错误处理逻辑统一。
多用户守卫适配的中间件增强
当项目存在多个 guard（如 api、admin、seller），默认的 auth:api 中间件只校验单一守卫。需确保所有 JWT 守卫都启用相同的过期感知能力：
- 确认每个 guard 的 driver 都设为
jwt，且 provider 指向对应用户模型（如admins表对应Admin模型）； - 在中间件中不硬编码守卫名，而是动态读取路由或请求上下文中的 guard 标识（例如通过请求头
X-Guard: admin或路由前缀识别）； - 推荐封装一个通用 JWT 认证中间件（如
EnsureJwtValid），内部调用Auth::guard($guard)->check()并捕获异常，避免重复逻辑。
刷新机制与双 Token 流程兜底
仅返回 401 不够友好。应配套提供可执行的恢复路径，尤其对多用户类型更需明确区分：
- 为每个用户类型提供独立的刷新接口（如
POST /api/admin/refresh、POST /api/seller/refresh），接收当前过期 token 和对应 refresh_token； - 刷新逻辑中验证
refresh_token是否有效且未被吊销（建议配合 blacklist 表或 Redis 缓存）； - 成功后返回新
access_token和更新后的refresh_token，并设置合理的refresh_ttl（如 7 天），确保用户在活跃期内无需频繁重登。
前端协同与状态码语义约定
后端统一处理只是半程。需与前端约定明确的行为规范：
- 所有 JWT 接口统一返回 401 且含
code: "token_expired"，前端全局拦截该 code，自动触发刷新流程； - 刷新失败（如 refresh_token 也过期）时，后端返回 401 +
code: "login_required"，前端跳转至对应用户类型的登录页（/admin/login或/seller/login）； - 避免前端自行解析 JWT 判断过期时间——服务端才是唯一可信源，防止客户端时间偏差导致误判。
