4. 拦截器设计模式：过滤器链模式、AOP切面模式、中间件模式在鉴权中的适用场景

在OpenAPI鉴权拦截器的工程落地中，选择合适的设计模式直接决定了系统的可维护性、扩展性和性能。本章深入剖析三种主流拦截模式——过滤器链模式、AOP切面模式和中间件模式，并结合鉴权场景给出选型建议。

4.1 三种模式的核心概念与架构对比

三种模式在职责划分、执行时机和侵入性上存在本质差异。下表从多个维度进行横向对比：

4.2 过滤器链模式：全局前置鉴权

过滤器链模式基于责任链设计思想，多个过滤器按顺序串联执行。在鉴权场景中，通常将Token校验、签名验证、IP限流等通用逻辑放在过滤器链的前端。

4.2.1 执行流程

1. 客户端发起HTTP请求到达Servlet容器。
2. 容器按注册顺序依次调用FilterChain中的每个Filter。
3. 每个Filter执行前置逻辑（如提取Token、校验签名），通过则调用chain.doFilter()传递请求。
4. 若鉴权失败，直接返回错误响应，中断链式传递。
5. 请求到达目标Servlet或Controller后，响应再逆序经过FilterChain。

4.2.2 代码示例：Token校验过滤器

public class TokenAuthFilter implements Filter {
    @Override
    public void doFilter(ServletRequest request, ServletResponse response,
                         FilterChain chain) throws IOException, ServletException {
        HttpServletRequest req = (HttpServletRequest) request;
        String token = req.getHeader("Authorization");

        if (token == null || !TokenValidator.validate(token)) {
            HttpServletResponse resp = (HttpServletResponse) response;
            resp.setStatus(HttpStatus.UNAUTHORIZED.value());
            resp.getWriter().write("{\"error\":\"Invalid or missing token\"}");
            return;
        }
        // 将解析后的用户信息存入请求属性
        req.setAttribute("userId", TokenValidator.getUserId(token));
        chain.doFilter(request, response);
    }
}

4.3 AOP切面模式：方法级细粒度鉴权

AOP切面模式通过动态代理在目标方法执行前后织入鉴权逻辑，特别适合需要根据方法参数、返回值或注解进行权限判断的场景。

4.3.1 核心概念

• 切点（Pointcut）：定义拦截范围，如@annotation(com.demo.RequireRole)。
• 通知（Advice）：定义拦截时机，如@Around环绕通知可完全控制方法执行。
• 连接点（JoinPoint）：方法执行时的上下文，可获取方法签名、参数和注解。

4.3.2 代码示例：基于注解的角色鉴权

@Aspect
@Component
public class RoleAuthAspect {

    @Around("@annotation(requireRole)")
    public Object checkRole(ProceedingJoinPoint joinPoint,
                            RequireRole requireRole) throws Throwable {
        // 从SecurityContext获取当前用户角色
        String currentRole = SecurityContextHolder.getContext()
                .getAuthentication().getRole();

        String requiredRole = requireRole.value();
        if (!currentRole.equals(requiredRole)) {
            throw new AccessDeniedException("Insufficient permissions");
        }
        return joinPoint.proceed();
    }
}

// 使用示例
@RestController
public class AdminController {
    @RequireRole("ADMIN")
    @GetMapping("/admin/users")
    public List<User> listUsers() {
        return userService.findAll();
    }
}

4.4 中间件模式：路由级灵活编排

中间件模式在Node.js（Express/Koa）和Go（Gin）等现代框架中广泛使用。每个中间件是一个独立函数，通过next()控制流程，天然支持异步和洋葱模型。

4.4.1 洋葱模型执行顺序

请求从外层中间件向内层传递，响应从内层向外层返回。这种模型非常适合鉴权、日志、错误处理等需要“前置校验+后置增强”的场景。

4.4.2 代码示例：Koa鉴权中间件

// 鉴权中间件
const authMiddleware = async (ctx, next) => {
    const token = ctx.headers['authorization'];
    if (!token) {
        ctx.status = 401;
        ctx.body = { error: 'Missing token' };
        return;
    }
    try {
        const decoded = jwt.verify(token, SECRET_KEY);
        ctx.state.user = decoded;  // 将用户信息存入上下文
        await next();              // 继续执行后续中间件
    } catch (err) {
        ctx.status = 403;
        ctx.body = { error: 'Invalid token' };
    }
};

// 路由级使用
router.get('/api/orders', authMiddleware, orderController.list);

4.5 三种模式的协同架构

在大型工程中，三种模式并非互斥，而是可以分层协同工作。下图展示了一个典型的协同架构：

4.6 选型决策矩阵

根据实际项目需求，可参考以下决策矩阵进行模式选择：