4. 拦截器链模式：责任链模式在鉴权中的应用、Filter/Interceptor/Aspect 对比

在多租户 SaaS 鉴权拦截链路中，单一拦截点往往无法覆盖所有安全诉求。从 IP 黑白名单、Token 校验、租户上下文注入 到 细粒度权限校验，每个环节都需要独立处理且可灵活编排。本章深入剖析责任链模式在鉴权链路中的落地方式，并对比 Filter、Interceptor、Aspect 三种拦截机制的适用场景与性能差异。

4.1 责任链模式在鉴权链路中的核心价值

责任链模式（Chain of Responsibility）将多个处理器串联成链，每个处理器决定是否处理请求以及是否将请求传递给下一个处理器。在鉴权场景中，该模式带来三大优势：

• 解耦：每个鉴权步骤（如 Token 校验、租户解析、权限判定）封装为独立节点，互不依赖。
• 可编排：通过配置即可调整链路的执行顺序，无需修改核心代码。
• 短路能力：一旦某个节点校验失败，立即终止链路，避免无效计算。

4.2 Filter / Interceptor / Aspect 对比

在 Spring 生态中，实现鉴权拦截链主要有三种机制：Filter、Interceptor、Aspect。它们在执行时机、作用范围、上下文访问能力上存在显著差异。

4.3 三种机制的代码实现对比

以下展示同一鉴权逻辑（Token 校验 + 租户注入）在三种机制下的实现差异：

Filter 实现

@Component
public class TenantAuthFilter implements Filter {
    @Override
    public void doFilter(ServletRequest request, ServletResponse response,
                         FilterChain chain) throws IOException, ServletException {
        HttpServletRequest req = (HttpServletRequest) request;
        String token = req.getHeader("X-Auth-Token");
        if (token == null || !TokenValidator.validate(token)) {
            ((HttpServletResponse) response).sendError(401, "Invalid token");
            return;
        }
        // 解析租户 ID 并注入 ThreadLocal
        String tenantId = TokenValidator.extractTenant(token);
        TenantContext.set(tenantId);
        try {
            chain.doFilter(request, response);
        } finally {
            TenantContext.clear();
        }
    }
}

Interceptor 实现

@Component
public class TenantAuthInterceptor implements HandlerInterceptor {
    @Override
    public boolean preHandle(HttpServletRequest request,
                             HttpServletResponse response, Object handler) {
        String token = request.getHeader("X-Auth-Token");
        if (token == null || !TokenValidator.validate(token)) {
            response.setStatus(401);
            return false;
        }
        String tenantId = TokenValidator.extractTenant(token);
        TenantContext.set(tenantId);
        return true;
    }

    @Override
    public void afterCompletion(HttpServletRequest request,
                                HttpServletResponse response,
                                Object handler, Exception ex) {
        TenantContext.clear();
    }
}

Aspect 实现

@Aspect
@Component
public class TenantAuthAspect {
    @Around("@annotation(requireAuth)")
    public Object checkAuth(ProceedingJoinPoint pjp,
                            RequireAuth requireAuth) throws Throwable {
        // 从请求上下文获取 Token（需配合 RequestContextHolder）
        HttpServletRequest request = ((ServletRequestAttributes)
            RequestContextHolder.getRequestAttributes()).getRequest();
        String token = request.getHeader("X-Auth-Token");
        if (token == null || !TokenValidator.validate(token)) {
            throw new AuthException("Token invalid");
        }
        String tenantId = TokenValidator.extractTenant(token);
        TenantContext.set(tenantId);
        try {
            return pjp.proceed();
        } finally {
            TenantContext.clear();
        }
    }
}

4.4 责任链模式与三种机制的融合策略

在实际架构中，责任链模式并非取代 Filter/Interceptor/Aspect，而是作为 编排引擎 嵌入其中。推荐以下融合方式：

• Filter 层：实现全局安全责任链（IP 黑白名单 → CORS → 请求日志），使用 OncePerRequestFilter 确保单次请求只执行一次。
• Interceptor 层：实现鉴权责任链（Token 校验 → 租户解析 → 角色判定），通过 Ordered 接口控制执行顺序。
• Aspect 层：实现方法级权限责任链（@RequireRole → @RequirePermission → @DataScope），利用 @Order 注解编排切面顺序。

4.5 选择建议与性能考量

根据多租户 SaaS 的典型流量特征，给出以下选择建议：