laravel jwt多表认证需构建多守卫并行体系：1.配置独立guard与provider；2.各模型实现jwtsubject并注入guard标识；3.所有auth操作显式指定guard；4.黑名单与缓存按guard隔离；5.路由中间件严格匹配guard名。
实现 Laravel JWT 多数据库表认证，核心不是“改一个配置”，而是构建多守卫（guard）并行体系——每个用户类型（如 users、admins、merchants）需拥有独立的 guard、provider、model 和 token 生命周期管理逻辑。否则 token 冲突、鉴权绕过或 401 错误不可避免。
1. 定义多个 guard 与 provider
在 config/auth.php 中显式添加各用户类型的 guard，并绑定专属 provider：
-
guard 配置：每个 guard 指定 driver 为
jwt，provider 名需唯一，例如：
'merchant' => ['driver' => 'jwt', 'provider' => 'merchants']
- provider 配置：每个 provider 绑定对应 Eloquent 模型，确保模型路径准确：
'merchants' => ['driver' => 'eloquent', 'model' => App\Models\Merchant::class]
注意：不能复用 users provider，否则所有 guard 都查 users 表，失去“多表”意义。
2. 模型必须实现 JWTSubject 并区分上下文
每个模型（Admin、Merchant 等）需实现 JWTSubject 接口，并在 getJWTCustomClaims() 中注入 guard 标识：
-
getJWTIdentifier()返回主键值（如$this->id）； -
getJWTCustomClaims()至少返回['guard' => 'admin']或['guard' => 'merchant']； - 该字段将进入 token payload，是后续隔离黑名单、刷新逻辑的关键依据。
3. Token 操作必须显式指定 guard
所有 Auth 调用不可省略 guard 名称，否则默认走 api guard，导致跨表误操作：
- 登录：
Auth::guard('admin')->login($admin)（不是Auth::login($admin)）； - 刷新：
Auth::guard('admin')->refresh()（否则刷新可能混用 users 的 payload）； - 登出：
Auth::guard('admin')->logout()（避免误删其他 guard 的 token）。
4. 黑名单与缓存需按 guard 隔离
tymon/jwt-auth 的 Blacklist 是单例，不自动感知 guard。若不做切片，Auth::guard('admin')->logout() 可能清空 users 的 token：
- 重写
add()方法，在 cache key 或数据库字段中拼入$payload['guard']，例如：blacklist:admin:abc123； - 或改用带前缀的 Redis 存储策略，确保不同 guard 的 token 互不干扰；
- 刷新接口响应头中的
Authorization也应基于当前 guard 生成新 token。
5. 路由与中间件严格匹配 guard 名
中间件名称必须包含 guard，且与路由、控制器调用保持一致：
- 路由示例：
Route::middleware('auth:admin')->group(...)； - 不能只写
auth:api或auth，否则中间件使用默认 guard 查 users 表； - 前端请求头仍为
Authorization: Bearer xxx，但服务端靠 payload 中的guard字段和中间件声明共同完成路由分流。
