3. 接口同步协议选型：RESTful vs GraphQL vs gRPC 在供应商场景下的对比

供应商目录接口同步的核心挑战在于：数据模型异构（不同供应商字段定义不同）、同步频率差异（全量/增量）、网络环境复杂（公网/专线/跨云）。选择错误的协议会导致接口开发成本高、同步失败率高、排障困难。本节从供应商目录同步的典型场景出发，对三种主流协议进行横向对比。

3.1 三种协议的核心差异

3.2 供应商目录场景下的协议选型分析

3.2.1 RESTful：适合标准化的供应商全量同步

RESTful 是目前供应商对接中最常见的协议。其优势在于生态成熟、调试方便，适合供应商数量不多（< 50 家）、接口规范统一的场景。

• 适用场景：供应商提供标准 REST API，返回固定字段的 JSON 数据；采购平台定时拉取全量目录。
• 痛点：当不同供应商返回的字段结构差异大时，客户端需要写大量适配代码；一次拉取可能包含大量不需要的字段（over-fetching），浪费带宽。

GET /api/v1/suppliers/{supplierId}/catalog?page=1&size=100
Host: supplier-platform.com
Authorization: Bearer {}

Response:
{
  "total": 5000,
  "items": [
    {
      "sku": "SP-001",
      "name": "工业轴承 6205",
      "price": 12.50,
      "currency": "CNY",
      "stock": 200,
      "category": "轴承",
      "specs": {
        "material": "铬钢",
        "weight_kg": 0.15
      }
    }
  ]
}

3.2.2 GraphQL：适合多供应商异构字段的增量同步

当采购平台需要对接数十家甚至上百家供应商，且每家供应商的目录字段差异较大时，GraphQL 的按需查询能力可以显著降低数据传输量和客户端适配成本。

• 适用场景：供应商提供统一的 GraphQL 端点，采购平台按需查询特定字段；适合增量同步场景，只拉取变更的字段。
• 优势：客户端可以精确指定需要的字段（如只拉取价格和库存），避免 over-fetching；Schema 强类型定义，接口文档自动生成。
• 劣势：查询复杂度高时可能造成服务端性能压力；缓存策略比 REST 复杂；部分供应商技术团队对 GraphQL 不熟悉。

3.2.3 gRPC：适合高频、大批量的流式同步

对于需要实时或准实时同步大量供应商目录数据的场景（如每日百万级 SKU 变更），gRPC 的二进制传输和流式通信能力具有明显优势。

• 适用场景：供应商与采购平台之间建立专线或内网连接；需要持续推送目录变更事件；数据量大且对延迟敏感。
• 优势：Protobuf 序列化后 Payload 体积比 JSON 小 60%-80%；支持 Server Streaming，供应商可以持续推送变更；强类型接口定义，代码生成减少适配错误。
• 劣势：浏览器端需要 gRPC-Web 代理；调试工具不如 REST 丰富；.proto 文件变更后需要重新生成客户端代码。

3.3 协议选型决策流程

以下决策流程帮助架构师在供应商目录同步场景中快速选择协议：

1. 供应商技术能力评估：供应商是否具备提供 GraphQL 或 gRPC 接口的能力？如果大部分供应商只支持 REST，则优先考虑 REST。
2. 数据量级评估：单次同步数据量是否超过 10MB？每日同步次数是否超过 1000 次？如果是，考虑 gRPC 或 GraphQL 减少传输量。
3. 字段异构程度：不同供应商的目录字段交集是否小于 70%？如果是，GraphQL 的按需查询能显著降低适配成本。
4. 实时性要求：是否需要秒级感知供应商目录变更？如果是，gRPC 的流式推送是最佳选择。
5. 团队技术栈：团队是否熟悉 Protobuf 或 GraphQL？如果团队以传统 Web 开发为主，REST 的维护成本最低。

3.4 协议选型架构图

下图展示了在供应商目录同步场景中，三种协议如何与采购平台的不同模块配合：

3.5 混合协议策略：对外兼容，对内高效

在实际的供应商目录同步平台中，单一协议往往无法满足所有场景。推荐采用混合协议策略：

• 对外接口：对供应商暴露 RESTful 或 GraphQL 接口，降低供应商对接门槛。对于技术能力强的供应商，优先推荐 GraphQL。
• 内部数据管道：采购平台内部的服务间通信统一使用 gRPC，利用其高性能和流式特性处理大规模目录数据。
• 协议转换层：在网关层实现协议适配，将外部 REST/GraphQL 请求转换为内部 gRPC 调用，对上层业务透明。