4. 超时定义与分类：连接超时、读取超时、任务处理超时、网关超时配置策略

在异步导出场景中，超时是触发网关重试与降级最直接的信号。如果超时定义模糊、分类不清，网关将无法准确判断“该重试”还是“该降级”。本章从网络层、协议层、业务层三个维度，系统定义四类超时，并给出网关侧的配置策略。

4.1 四类超时的定义与边界

超时类型	层级	定义	典型阈值	触发后网关行为
连接超时	网络传输层	客户端发起 TCP 握手后，在指定时间内未收到 SYN-ACK	1s ~ 5s	直接返回 504，不重试（避免连接雪崩）
读取超时	协议数据层	已建立连接，但在指定时间内未收到服务端响应的第一个字节	5s ~ 15s	可重试 1~2 次，需配合幂等令牌
任务处理超时	业务逻辑层	异步导出任务从提交到完成的总耗时超过业务约定上限	30s ~ 300s	查询任务状态后决定降级或取消
网关超时	网关配置层	网关自身设定的全局或路由级最大等待时间	10s ~ 60s	切断链路，触发熔断或降级策略

4.2 超时分类的层次关系

下图展示了从客户端发起请求到异步任务完成的全链路超时层次，以及各层超时在网关中的映射关系。

4.3 网关超时配置策略

网关超时是全局兜底机制，配置不当会导致误重试或资源耗尽。以下给出生产级配置策略。

4.3.1 连接超时配置

• 原则：短超时 + 不重试。连接失败说明网络或服务不可用，重试只会加剧拥塞。
• 推荐值：内网服务 1s，跨机房 3s，公网调用 5s。
• 配置示例（Nginx / Kong）：

# Nginx upstream 连接超时
proxy_connect_timeout 3s;

# Kong 路由级连接超时
configs:
  connect_timeout: 3000  # 单位 ms

4.3.2 读取超时配置

• 原则：中等超时 + 幂等重试。读取超时可能是服务端 GC 或慢查询，重试前必须保证请求幂等。
• 推荐值：同步接口 10s，异步提交接口 15s。
• 配置示例：

# Nginx 读取超时
proxy_read_timeout 10s;

# Spring Cloud Gateway 路由级配置
spring:
  cloud:
    gateway:
      routes:
        - id: export_route
          uri: lb://export-service
          predicates:
            - Path=/api/v1/export/**
          metadata:
            response-timeout: 10000  # 10s

4.3.3 任务处理超时配置

• 原则：长超时 + 异步状态轮询。任务处理超时不能直接触发重试，应返回任务 ID 让客户端轮询。
• 推荐值：根据业务 SLA 设定，通常 60s ~ 300s。
• 实现方式：网关侧维护一个超时任务表，超时后主动查询任务状态。

// 伪代码：网关任务超时处理
if (taskTimeout(taskId, 120_000)) {
    TaskStatus status = queryTaskStatus(taskId);
    if (status == RUNNING) {
        // 任务仍在执行，延长超时或返回客户端重试
        return Response.accepted(taskId, "任务处理中，请稍后查询");
    } else if (status == FAILED) {
        // 任务失败，触发降级
        return Response.error(503, "导出任务超时失败");
    }
}

4.3.4 网关全局超时配置

• 原则：网关超时 < 后端服务超时，确保网关先断开，避免后端线程堆积。
• 推荐值：网关超时 = 后端超时 × 0.8。
• 配置示例：

# 网关全局超时（Kong）
proxy_read_timeout: 8000   # 8s
proxy_connect_timeout: 3000 # 3s
proxy_send_timeout: 8000    # 8s

# 后端服务超时（假设为 10s）
# 网关 8s < 后端 10s ✅ 符合原则

4.4 超时配置的优先级与覆盖规则

网关通常支持多级超时配置，优先级从高到低为：路由级 > 服务级 > 全局默认。异步导出接口应单独设置路由级超时，避免被全局短超时误杀。

配置层级	作用范围	异步导出推荐值	说明
全局默认	所有路由	连接 3s / 读取 10s	兜底值，防止未配置的路由无限等待
服务级	特定 upstream	连接 3s / 读取 15s	针对导出服务整体调优
路由级	特定 Path 或 Method	连接 5s / 读取 20s	异步导出接口专用，允许更长等待

4.5 超时与重试、降级的联动关系

超时不是孤立事件，它直接驱动网关的下一步动作。下图展示超时发生后网关的决策树。