4. 连接池故障模式概览：连接泄漏、连接饥饿、连接超时、连接重置、连接数超限

在 Service Mesh 升级过程中，Envoy 的连接池是数据路径上的关键组件。连接池管理着上游集群的 TCP 连接与 HTTP 流，一旦出现故障，会直接表现为请求延迟增加、错误率飙升甚至服务中断。本节系统梳理五种最常见的连接池故障模式，帮助你在升级前后快速定位根因。

4.1 连接泄漏 (Connection Leak)

连接泄漏是指连接池中的连接在使用完毕后未被正确归还到池中，导致连接对象被遗弃。在 Envoy 中，这通常表现为 upstream_cx_active 持续增长，而 upstream_cx_destroyed 远低于预期。

• 典型原因：HTTP/2 流未正确关闭、WebSocket 连接未触发析构、自定义 Filter 未释放连接引用。
• 升级场景：新版本 Envoy 的流处理逻辑变更，导致部分边缘 case 未覆盖。
• 排查指标：envoy_cluster_upstream_cx_active、envoy_cluster_upstream_cx_destroyed。

4.2 连接饥饿 (Connection Starvation)

连接饥饿指所有可用连接均被占用，新请求无法获取连接而排队等待。Envoy 连接池的 max_requests_per_connection 或 max_connections 设置不当是常见诱因。

4.3 连接超时 (Connection Timeout)

连接超时包括建立连接超时和等待空闲连接超时。Envoy 通过 connect_timeout 和 idle_timeout 控制，升级后若超时配置被覆盖或网络延迟增加，会触发大量 503/504。

4.4 连接重置 (Connection Reset)

连接重置指连接被对端或 Envoy 主动关闭，表现为 RST 包。在升级过程中，新旧版本 Envoy 的协议处理差异（如 HTTP/2 的 GOAWAY 帧处理）是主要诱因。

• 本地重置：Envoy 因资源限制主动关闭连接，对应 upstream_cx_destroy_local。
• 远程重置：上游服务主动断开，对应 upstream_cx_destroy_remote。
• 协议重置：HTTP/2 的 RST_STREAM 帧，对应 upstream_rq_rx_reset。

4.5 连接数超限 (Connection Limit Exceeded)

连接数超限是断路器 (Circuit Breaker) 触发的保护行为。Envoy 的断路器基于 max_connections、max_pending_requests、max_requests 和 max_retries 四个阈值。

# 典型断路器配置示例
circuit_breakers:
  thresholds:
    - priority: DEFAULT
      max_connections: 1024
      max_pending_requests: 1024
      max_requests: 1024
      max_retries: 3
    - priority: HIGH
      max_connections: 2048
      max_pending_requests: 2048
      max_requests: 2048
      max_retries: 5

当任意阈值被触发，Envoy 会直接拒绝新请求，返回 503。升级时若未同步调整断路器参数，极易触发超限。

4.6 故障模式对比速查表