tRPC与GraphQL Federation深度对比：2026年全栈API方案选型与工程落地

二、类型系统与开发者体验

2.1 tRPC的类型链：从服务端到客户端的无损传递

tRPC的类型系统是其最大卖点。以下示例展示了完整的工作流：

// server/trpc.ts
import { initTRPC } from "@trpc/server";
import { z } from "zod";

const t = initTRPC.create();

const appRouter = t.router({
  user: t.router({
    getById: t.procedure
      .input(z.object({ id: z.string() }))
      .query(async ({ input }) => {
        return await db.user.findUnique({ where: { id: input.id } });
      }),
  }),
});

export type AppRouter = typeof appRouter;

// client/api.ts
import { createTRPCProxyClient, httpBatchLink } from "@trpc/client";
import type AppRouter from "../server/trpc";

const trpc = createTRPCProxyClient({
  links: [httpBatchLink({ url: "/api/trpc" })],
});

// 完全类型安全！参数和返回值自动推断
const user = await trpc.user.getById.query({ id: "123" });
// user 的类型自动推断为 { id: string; name: string; email: string }

2.2 Federation的类型协调：跨服务的Schema一致性

Federation通过Schema注册中心（如Apollo Studio、GraphOS）确保所有子图的组合一致性。每个子图通过sdl声明自己贡献的类型和字段，Router在启动时拉取所有子图Schema并执行查询规划。

// users subgraph
type User @key(fields: "id") {
  id: ID!
  name: String!
  email: String! @shareable
}

// posts subgraph
type Post @key(fields: "id") {
  id: ID!
  title: String!
  author: User @external
}

extend type User @key(fields: "id") {
  id: ID! @external
  posts: [Post]
}

三、性能基准对比

四、生产级工程实践

4.1 tRPC最佳实践

• Procedure拆分：按业务域组织Router，避免单文件膨胀
• 中间件链：利用tRPC middleware实现鉴权、日志、限流横切关注点
• React Query集成：与tRPC深度联动，提供开箱即用的缓存与乐观更新
• 批量请求：httpBatchLink自动合并同帧请求，减少网络往返
• SSR/Streaming：与Next.js App Router深度集成，支持服务端流式渲染

4.2 Federation最佳实践

• 子图边界设计：按限界上下文划分服务，每个子图不超过50个类型
• 实体键设计：优先使用业务主键，避免使用技术自增ID作为key
• 查询复杂度限制：配置depth limit、complexity score，防止恶意深度查询
• 持久化查询：生产环境强制使用Persisted Queries，减少Router开销
• 子图版本管理：通过Schema Change Review流程管控跨团队Breaking Changes

五、选型决策矩阵

六、混合架构：tRPC与Federation的协同

实际生产中，两种方案并非互斥。可以采用tRPC用于前端-BFF层、Federation用于BFF-微服务层的混合架构：前端通过tRPC获得端到端类型安全调用BFF服务，BFF层通过Federation聚合底层微服务数据，各层各取所长。这种分层方案已在多个中大型项目中验证了其工程可行性。

结论

tRPC和GraphQL Federation代表了2026年全栈API架构的两条技术路线：tRPC追求开发体验的极致简化，通过TypeScript类型系统消除API契约维护成本；GraphQL Federation追求大规模系统的组织协作效率，通过分布式Schema编排支撑多团队并行演进。技术选型应基于团队规模、业务复杂度与客户端多样性三个核心维度做出判断，而非简单的二元对立。