3. 路由分发基本原理

路由分发是 API Gateway 的核心职能，它决定了“一个请求到达网关后，应该转发给哪个后端微服务”。理解路由表结构、匹配规则与优先级机制，是正确配置网关接入的基础。本章从这三个维度展开，帮助你在实际项目中设计出清晰、可维护的路由策略。

3.1 路由表结构

路由表是网关内部维护的一组有序规则集合，每条规则定义了一组匹配条件与一个目标后端。典型的单条路由条目包含以下核心字段：

路由表在网关启动时加载到内存中，通常以 有序列表 或 前缀树（Trie） 的形式存储。前缀树结构在路径匹配场景下具有 O(L) 的时间复杂度（L 为路径长度），适合高并发场景。

3.2 匹配规则

网关支持多维度的请求匹配，常见的匹配维度包括路径、HTTP 方法和请求头。匹配过程遵循“与（AND）”逻辑——所有条件同时满足才算匹配成功。

3.2.1 路径匹配

路径匹配是最基础也是最常用的规则。主流网关支持以下三种路径模式：

• 精确匹配： /api/user/login —— 仅匹配该完整路径。
• 前缀匹配： /api/user/** —— 匹配以 /api/user/ 开头的所有路径。
• 参数化匹配： /api/user/{id} —— 匹配 /api/user/123，并将 id 提取为路径参数。

3.2.2 方法匹配

方法匹配用于限制请求的 HTTP 动词。常见用法包括：

• 单方法： GET —— 只允许 GET 请求。
• 多方法： GET, POST, PUT —— 允许列表中的多个方法。
• 全匹配： 不配置方法字段，默认匹配所有 HTTP 方法。

3.2.3 Header 匹配

Header 匹配用于实现灰度发布、版本路由、A/B 测试等高级场景。常见的匹配方式包括：

3.3 路由优先级

当多个路由规则同时匹配一个请求时，网关必须通过优先级机制决定最终使用哪一条。优先级规则通常遵循以下原则：

1. 显式优先级优先： 路由表中 Priority 字段数值越小，优先级越高。例如 Priority=1 的路由优先于 Priority=10 的路由。
2. 路径精确度优先： 在未显式配置优先级时，路径匹配越精确，优先级越高。例如 /api/user/login（精确匹配）优先于 /api/user/**（前缀匹配）。
3. 配置顺序优先： 当显式优先级和路径精确度都无法区分时，路由表中先配置的规则优先匹配。

下图展示了路由匹配与优先级决策的完整流程：

3.4 综合匹配示例

以下是一个实际的路由表配置示例，展示了多维度匹配与优先级协同工作的场景：

# 路由表配置（YAML 格式）
routes:
  - id: user-gray-v2
    path: /api/user/**
    method: GET
    headers:
      X-Version: v2
    target: lb://user-service-v2
    priority: 1

  - id: user-stable
    path: /api/user/**
    method: GET
    target: lb://user-service-v1
    priority: 10

  - id: user-admin
    path: /api/user/admin
    method: POST
    target: lb://admin-service
    priority: 5

在这个示例中：

• 当请求 GET /api/user/profile 携带 X-Version: v2 时，匹配 user-gray-v2（优先级 1），转发到 v2 服务。
• 当请求 GET /api/user/profile 不携带版本头时，匹配 user-stable（优先级 10），转发到 v1 服务。
• 当请求 POST /api/user/admin 时，虽然路径前缀也匹配前两条路由，但方法不匹配，最终匹配 user-admin（优先级 5）。