3. gRPC 拦截器机制：客户端拦截器与服务端拦截器的原理、拦截器链的执行顺序

gRPC 拦截器（Interceptor）是框架提供的一种 AOP（面向切面编程） 能力，允许开发者在 RPC 调用链的关键切面注入横切逻辑，而无需侵入业务代码。拦截器是 gRPC 熔断降级、超时控制、日志审计、认证鉴权等中间件能力的底层基础设施。

3.1 拦截器的分类与角色

gRPC 将拦截器按部署位置分为两大类：客户端拦截器 和 服务端拦截器。每一类又根据拦截的调用类型细分为 一元拦截器（Unary Interceptor）和 流式拦截器（Stream Interceptor）。

3.2 拦截器链与执行顺序

gRPC 允许注册多个拦截器，它们会按照注册顺序形成一条 拦截器链。拦截器链的执行顺序遵循 洋葱模型：请求从最外层拦截器向内层传递，响应从最内层拦截器向外层返回。

3.3 客户端拦截器原理

客户端拦截器在 Channel 与 CallOptions 层面生效。当 Stub 发起调用时，拦截器链会依次拦截 ClientCall 的创建与执行过程。

3.3.1 一元拦截器接口

// ClientInterceptor 接口定义
public interface ClientInterceptor {
  <ReqT, RespT> ClientCall<ReqT, RespT> interceptCall(
      MethodDescriptor<ReqT, RespT> method,
      CallOptions callOptions,
      Channel next
  );
}

• method：被调用的 RPC 方法描述符，包含方法名、请求/响应类型、序列化方式。
• callOptions：调用选项，可附加超时、deadline、自定义属性。
• next：下一个 Channel 或拦截器，调用 next.newCall() 将请求传递到链的下一个节点。

3.3.2 客户端拦截器注册

// 注册多个客户端拦截器
ManagedChannel channel = ManagedChannelBuilder.forAddress("localhost", 8080)
    .intercept(new LoggingInterceptor())      // 拦截器 A
    .intercept(new CircuitBreakerInterceptor()) // 拦截器 B
    .intercept(new RetryInterceptor())         // 拦截器 C
    .build();

3.4 服务端拦截器原理

服务端拦截器在 ServerServiceDefinition 或 ServerInterceptor 层面生效。当服务端收到请求时，拦截器链会依次拦截 ServerCall 的创建与处理过程。

3.4.1 一元拦截器接口

// ServerInterceptor 接口定义
public interface ServerInterceptor {
  <ReqT, RespT> ServerCall.Listener<ReqT> interceptCall(
      ServerCall<ReqT, RespT> call,
      Metadata headers,
      ServerCallHandler<ReqT, RespT> next
  );
}

• call：服务端调用对象，可控制响应发送、状态设置。
• headers：请求元数据，常用于提取认证 token、trace ID。
• next：下一个处理器，调用 next.startCall() 将请求传递到链的下一个节点或实际业务方法。

3.4.2 服务端拦截器注册

// 注册多个服务端拦截器
Server server = ServerBuilder.forPort(8080)
    .intercept(new AuthInterceptor())          // 拦截器 A
    .intercept(new RateLimitInterceptor())     // 拦截器 B
    .intercept(new AccessLogInterceptor())     // 拦截器 C
    .addService(new MyServiceImpl())
    .build();

3.5 拦截器链执行顺序对比

3.6 拦截器链的异常传播

当拦截器链中的某个节点抛出异常时，异常会沿着响应路径反向传播，跳过尚未执行的拦截器节点。这一机制对熔断降级至关重要：

• 客户端熔断拦截器 在请求方向检测熔断状态，若熔断打开则直接抛出异常，不再调用后续拦截器。
• 服务端限流拦截器 在请求方向检测限流阈值，若超过阈值则直接返回 UNAVAILABLE 状态码，业务方法不会被调用。
• 异常封装拦截器 通常注册在最外层，用于捕获链内所有未处理异常，统一转换为 gRPC 状态码。

3.7 拦截器链的性能考量