Apollo Federation 选用指南:两个团队需要拆成两个子图吗?

先确认字段归属与实体键一致,再决定是否增加组合和路由的维护成本。

来源: www.apollographql.com
2026年8月30日
2 min

两个团队不等于需要联邦。若同一团队仍负责部署和排障,把单一 GraphQL 模式按代码模块拆分通常更简单。只有目录与库存独立发布、客户端又需要一次取到两边的字段时,才考虑 Apollo Federation。Apollo 2022 年发布 Federation 2;官方规则说明,子图可通过实体键为同一实体贡献不同字段,重复声明字段通常不被允许,除非明确可共享并满足兼容规则。 (官方组合规则)

用三个编号核对归属

拿虚构纸灯做静态评审:目录持有名称,库存持有可用数量;两个子图约定使用稳定的道具编号做实体键。A 是目录中的 A-17「纸灯」,B 是库存里的 A-17(余 3),应组合出名称与 3。C 是库存里的 B-04,即使叫同一个名字,也不能拼到 A-17。

Article img
三张卡分别写 A-17、A-17、B-04,只有前两张匹配。

原创示意,不是运行结果。名称一致不能代替编号一致。

评审时先写清谁能改键、谁对数量负责,再拿正确键、错键和缺库存三种样例检查预期。缺库存要约定如何表示未知,不能悄悄变成 0。模式能组合,不代表键对应的实物正确,或运行时能拿到库存;这是另一层验收。只在边界和故障责任清楚、独立发布能省下经常性的协调成本时采用联邦,否则保留单图。样例不连账号、真实目录或运行中的服务。

内容说明:本文基于公开资料整理,仅供工具选型参考。产品功能、价格及相关政策可能随时调整,请以官方最新信息为准。

原文出处:www.apollographql.com