← 返回学习路线

SYSTEM

第 5 步:Filter 鉴权链路 —— 两层检查 + 降级兜底

后端实战第 5 步:Filter 鉴权链路 —— 两层检查 + 降级兜底blog-dev
src/content/notes/blog-dev/第-5-步:Filter-鉴权链路-——-两层检查-降级兜底.md

第 5 步:Filter 鉴权链路 —— 两层检查 + 降级兜底

思路

Filter 每次请求执行两层检查,Redis 不可用时降级查 DB,保证鉴权链路不因 Redis 宕机而全链路崩溃。

完整流程图

请求到达 JwtAuthenticationFilter
       │
       ▼
┌──────────────────────────────┐
│ ① 提取 Token(处理 Bearer)  │
└─────────────┬────────────────┘
              │
              ▼
┌──────────────────────────────┐
│ ② Token 为 null?            │
│  └─ 是 → 放行(匿名访问)     │
│  └─ 否 → 继续                │
└─────────────┬────────────────┘
              │
              ▼
┌──────────────────────────────┐
│ ③ validateToken 签名校验     │
│  └─ 失败 → clearContext 放行 │
│  └─ 成功 → 解析 jti/userId  │
└─────────────┬────────────────┘
              │
              ▼
┌──────────────────────────────┐
│ ④ 黑名单检查(jti)          │
│  └─ 在黑名单 → 拒绝          │
│  └─ 不在 → 继续              │
└─────────────┬────────────────┘
              │
              ▼
┌──────────────────────────────┐
│ ⑤ 禁用状态检查              │
│  └─ Redis hasKey             │
│      ├─ true → 拒绝          │
│      ├─ false → 放行         │
│      └─ Redis 宕机 →         │
│         降级查 DB enabled     │
│          ├─ false → 拒绝     │
│          └─ true → 放行      │
└─────────────┬────────────────┘
              │
              ▼
     设置 SecurityContext → 放行

核心代码

文件:JwtAuthenticationFilter.java

// 第 1 层检查:Token 黑名单(用 jti,零碰撞)
if (Boolean.TRUE.equals(redisUtil.hasKey(TOKEN_BLACKLIST_KEY + jti))) {
    SecurityContextHolder.clearContext();
    filterChain.doFilter(request, response);
    return;
}

// 第 2 层检查:用户禁用标记(Redis + DB 降级兜底)
if (isUserDisabled(userId)) {
    SecurityContextHolder.clearContext();
    filterChain.doFilter(request, response);
    return;
}

降级方法:

private boolean isUserDisabled(Long userId) {
    try {
        // 正常路径:查 Redis,0.1ms
        return Boolean.TRUE.equals(redisUtil.hasKey(USER_DISABLED_KEY + userId));
    } catch (RedisConnectionFailureException e) {
        // Redis 宕机降级:临时查 DB enabled 字段兜底
        Optional<User> userOpt = userRepository.findById(userId);
        return userOpt.map(u -> !u.getEnabled()).orElse(true);
    } catch (DataAccessException e) {
        // Redis 和 DB 都不可用 → 保守策略:拒绝
        return true;
    }
}

降级策略设计

场景 行为 合理性
Redis 正常 查 Redis(0.1ms) 正常路径,高性能
Redis 宕机 降级查 DB(~5ms) 保证鉴权不中断,临时降速
Redis + DB 都宕机 保守拒绝(返回 true) 安全优先,避免绕过权限检查