4. 拦截器/过滤器设计模式：AOP思想、Java Filter vs Interceptor、Go Middleware模式、责任链模式

在多租户SaaS鉴权拦截链路中，如何将“租户识别→Token校验→权限判定→异常捕获”等横切关注点与核心业务逻辑解耦，是架构设计的关键。本章深入剖析四种核心设计模式与实现机制：AOP思想、Java Filter与Interceptor、Go Middleware模式以及责任链模式，帮助你在不同技术栈中构建可扩展、可维护的鉴权拦截链路。

4.1 AOP思想：横切关注点的解耦基石

AOP（Aspect-Oriented Programming，面向切面编程）是拦截器与过滤器设计的理论基础。其核心思想是将横切关注点（如鉴权、日志、事务）从业务逻辑中抽离，通过“切面”统一管理。

核心概念：
  • 切面（Aspect）： 横切关注点的模块化，如“鉴权切面”。
  • 连接点（Join Point）： 程序执行过程中的特定点，如方法调用、异常抛出。
  • 通知（Advice）： 在连接点执行的动作，包括前置（Before）、后置（After）、环绕（Around）等。
  • 切入点（Pointcut）： 匹配连接点的表达式，决定通知在何处执行。

在SaaS鉴权场景中，AOP允许你在不侵入业务代码的前提下，为所有Controller方法织入租户上下文解析与Token校验逻辑。

AOP 核心概念关系图 业务逻辑 （核心关注点） 横切关注点 （鉴权/日志/事务） 切面（Aspect） 模块化封装 连接点（Join Point） 通知（Advice） 切入点（Pointcut）

4.2 Java Filter vs Interceptor：容器级与应用级的抉择

在Java Web应用中，Filter与Interceptor是实现拦截链路的两种主要机制，但它们在作用域、执行时机与能力上存在显著差异。

对比维度 Filter（过滤器） Interceptor（拦截器）
所属容器 Servlet容器（如Tomcat） Spring容器（IoC管理）
作用范围 所有Web资源（包括静态资源） 仅Spring管理的Controller方法
执行时机 请求进入Servlet之前/之后 HandlerMapping之后，HandlerAdapter之前
获取请求体 可以（通过ServletRequest） 可以（通过HttpServletRequest）
获取方法参数 不能直接获取 可以（通过Method参数）
多次请求处理 每个请求仅执行一次 可针对方法执行前后多次拦截
典型用途 字符编码、跨域CORS、XSS过滤 鉴权、日志、性能监控
架构建议： 在SaaS鉴权链路中，推荐使用Filter处理租户上下文初始化（如从Header提取Tenant-ID），使用Interceptor处理Token校验与权限判定。Filter更靠近网络层，适合做全局预处理；Interceptor更贴近业务，能获取方法签名与注解信息。

4.3 Go Middleware模式：链式函数组合的艺术

Go语言中，Middleware模式通过函数式编程实现请求拦截链。其核心是http.Handler接口的嵌套调用，每个Middleware接收一个Handler，返回一个新的Handler。

// Go Middleware 核心模式
type Middleware func(http.Handler) http.Handler

// 鉴权中间件示例
func AuthMiddleware(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        // 1. 提取Token
        token := r.Header.Get("Authorization")
        if token == "" {
            http.Error(w, "Unauthorized", http.StatusUnauthorized)
            return
        }
        // 2. 校验Token（伪代码）
        if !validateToken(token) {
            http.Error(w, "Forbidden", http.StatusForbidden)
            return
        }
        // 3. 将租户信息注入Context
        ctx := context.WithValue(r.Context(), "tenantID", extractTenant(token))
        next.ServeHTTP(w, r.WithContext(ctx))
    })
}

// 链式组合
func main() {
    mux := http.NewServeMux()
    mux.Handle("/api/orders", AuthMiddleware(TenantMiddleware(LoggerMiddleware(OrderHandler))))
}

Go Middleware的链式调用本质上是装饰器模式的变体，每个中间件只关注单一职责，通过组合形成完整的拦截链路。

Go Middleware 链式调用流程 HTTP请求 Logger Middleware Auth Middleware Tenant Middleware OrderHandler 响应逐层返回

4.4 责任链模式：灵活编排拦截节点

责任链模式（Chain of Responsibility）是拦截器链路的经典设计模式。它将多个处理节点串联成链，请求沿着链传递，直到某个节点处理完毕或链结束。

责任链模式在SaaS鉴权中的典型节点编排：
  1. RateLimitNode： 检查租户API调用频率，超出则直接拒绝。
  2. TokenValidateNode： 解析并校验JWT Token的有效性。
  3. TenantContextNode： 从Token中提取租户ID，注入线程上下文。
  4. PermissionCheckNode： 校验当前用户是否拥有访问资源的权限。
  5. AuditLogNode： 记录请求与响应的审计日志。

与Java Filter链或Go Middleware链不同，责任链模式允许节点动态决定是否继续传递，甚至可以在链中插入或移除节点，非常适合SaaS多租户场景下的差异化鉴权策略。

// 责任链模式核心接口（Java示例）
public interface AuthNode {
    void handle(AuthRequest request, AuthChain chain);
}

public class AuthChain {
    private List<AuthNode> nodes = new ArrayList<>();
    private int index = 0;

    public void proceed(AuthRequest request) {
        if (index < nodes.size()) {
            nodes.get(index++).handle(request, this);
        }
    }
}

// 具体节点：Token校验
public class TokenValidateNode implements AuthNode {
    @Override
    public void handle(AuthRequest request, AuthChain chain) {
        if (!validateToken(request.getToken())) {
            throw new AuthException("Invalid token");
        }
        // 继续传递
        chain.proceed(request);
    }
}

4.5 四种模式对比与选型建议

模式 语言/框架 粒度 动态性 适用场景
AOP Java (Spring AOP / AspectJ) 方法级 编译期/运行时织入 通用横切逻辑（日志、事务）
Filter Java Servlet 请求级 静态配置 全局预处理（编码、CORS）
Interceptor Java Spring MVC 方法级 可配置拦截路径 业务鉴权、权限校验
Middleware Go (net/http, Gin, Echo) 请求级 链式组合 微服务API网关、鉴权链路
责任链 通用（Java/Go/Python） 自定义 运行时动态编排 复杂鉴权流程、多租户差异化策略
常见陷阱：
  • Filter中获取请求体后未缓存： 导致后续Interceptor或Controller无法再次读取InputStream。解决方案：使用ContentCachingRequestWrapper。
  • Go Middleware中Context传递丢失： 未正确使用context.WithValue传递租户信息，导致下游无法获取。
  • 责任链节点顺序错误： 将权限校验放在Token校验之前，导致未认证用户也能触发权限逻辑。

在实际的多租户SaaS项目中，通常采用混合架构：Filter负责租户上下文初始化，Interceptor或Middleware负责核心鉴权逻辑，责任链模式用于实现可插拔的权限校验策略。理解这些模式的本质差异，是构建高可用、可扩展鉴权拦截链路的基础。

← 上一章 📖 返回目录 下一章 →