3. gRPC 调用异常全景：超时、连接重置、资源耗尽、DeadlineExceeded 等常见异常分类

在分布式系统中，gRPC 调用异常是服务间通信失败的直接体现。当数据库迁移引发 GC 停顿（Stop-The-World）时，gRPC 客户端会观察到一系列特征性异常。理解这些异常的分类、触发条件与根因，是定位“GC 停顿导致调用失败”的关键第一步。本章对 gRPC 常见异常进行全景式分类，并重点分析与 GC 停顿相关的异常模式。

3.1 异常分类总览

gRPC 异常按触发源可分为四大类：超时类、连接类、资源耗尽类、协议语义类。下表列出了各类异常的核心特征与典型 gRPC 状态码。

3.2 超时类异常：DeadlineExceeded

DeadlineExceeded 是 gRPC 中最常见的超时异常。客户端在发起 RPC 调用时设置一个截止时间（Deadline），若服务端在该时间内未返回响应，客户端侧即抛出此异常。

• 触发机制：客户端启动一个定时器，到达 Deadline 时取消 RPC 调用并返回 DEADLINE_EXCEEDED 状态码。
• GC 停顿关联：当服务端发生 Full GC 或长时间 Young GC（如超过 1 秒），服务线程被暂停，无法处理请求或发送响应。客户端等待超时后直接失败。
• 典型表现：调用日志中出现 io.grpc.StatusRuntimeException: DEADLINE_EXCEEDED，且伴随服务端 GC 日志中长时间的 STW 停顿。

// 客户端设置 Deadline 示例（Java）
GreeterGrpc.GreeterFutureStub stub = GreeterGrpc.newFutureStub(channel)
    .withDeadlineAfter(500, TimeUnit.MILLISECONDS); // 500ms 超时
ListenableFuture<HelloReply> response = stub.sayHello(request);
try {
    response.get();
} catch (ExecutionException e) {
    if (Status.fromThrowable(e).getCode() == Status.Code.DEADLINE_EXCEEDED) {
        // 处理超时逻辑
    }
}

3.3 连接类异常：UNAVAILABLE 与连接重置

连接类异常通常表现为 UNAVAILABLE（服务不可用）或 INTERNAL（内部错误），底层对应 HTTP/2 连接重置、TCP 连接断开或 GOAWAY 帧接收。

• UNAVAILABLE：gRPC 客户端在建立连接或发送请求时，发现服务端无法接受请求（如连接池无可用连接、服务端主动关闭连接）。
• 连接重置（Connection Reset）：TCP 层面收到 RST 包，通常由对端进程崩溃、GC 停顿导致心跳超时后对端主动断开引起。
• GC 停顿关联：服务端 GC 停顿期间，HTTP/2 的 PING 帧（用于保活）无法及时回复。客户端检测到 PING 超时后，判定连接失效，抛出 UNAVAILABLE 异常。

3.4 资源耗尽类异常：RESOURCE_EXHAUSTED

RESOURCE_EXHAUSTED 表示服务端或客户端资源已耗尽，无法处理更多请求。常见原因包括：

• 内存溢出：GC 停顿后，堆内存碎片化严重，无法分配新对象。
• 线程池满：服务端请求处理线程被长时间阻塞（如等待 GC 恢复），新请求无法被接受。
• 连接池耗尽：客户端连接池中的连接全部处于等待或超时状态。
• HTTP/2 流控窗口满：服务端因 GC 停顿无法消费数据，导致客户端流控窗口被填满，无法发送更多请求。

在 GC 停顿场景中，RESOURCE_EXHAUSTED 通常是二次效应：停顿本身不直接触发该异常，但停顿结束后，大量积压请求同时涌入，瞬间耗尽线程池或内存，从而抛出该异常。

3.5 异常关联全景图

下图展示了 gRPC 调用异常与 GC 停顿之间的关联路径。从 GC 停顿出发，经过不同的中间状态，最终映射到客户端观察到的异常类型。

3.6 异常诊断优先级矩阵

在实际诊断中，不同异常组合对应不同的根因概率。下表给出了基于 GC 停顿场景的异常诊断优先级建议。

3.7 异常传播链示例

以下是一个典型的 GC 停顿引发 gRPC 异常传播链，展示了从 GC 事件到客户端异常的完整路径。

1. 触发：数据库迁移触发 Full GC，服务端 JVM 进入 STW 状态，持续 2.3 秒。
2. 服务线程暂停：所有 gRPC 服务线程被挂起，无法处理任何请求或发送响应。
3. 客户端超时：客户端设置的 Deadline 为 1 秒，等待 1 秒后未收到响应，抛出 DEADLINE_EXCEEDED。
4. 连接断开：服务端 GC 停顿期间，HTTP/2 PING 帧未回复，客户端 keepalive 检测到连接失效，关闭连接并抛出 UNAVAILABLE。
5. 资源耗尽：GC 结束后，大量重试请求同时涌入，服务端线程池瞬间被占满，后续请求抛出 RESOURCE_EXHAUSTED。
6. 客户端观察：在 2-5 秒的时间窗口内，客户端日志中依次出现 DEADLINE_EXCEEDED、UNAVAILABLE、RESOURCE_EXHAUSTED 三种异常。