SuperAPI AI 工具集

tRPC

编程与开发

查看项目

更新于 10-16 03:13

技能介绍

用途:tRPC(TypeScript Remote Procedure Call)用于构建端到端类型安全的 API,服务端到客户端全程 TypeScript 类型推断,无需 schema 或代码生成,适合 Next.js、React Query 等技术栈。

主要能力:支持 router 定义、query/mutation/subscription 过程、嵌套与合并路由、基于 Zod 的输入校验、context 上下文、middleware 中间件(含鉴权与角色控制)、客户端查询与变更、乐观更新、无限查询、错误处理与错误码、服务端调用、请求批处理与去重、自定义请求头等。

使用方式:安装核心包 npm install @trpc/server@next @trpc/client@next @trpc/react-query@next,并安装 peer 依赖 npm install @tanstack/react-query@latest zod。基本流程为:用 initTRPC 创建 t 实例并导出 router 与 procedure;定义 appRouter 并导出 AppRouter 类型;在 Next.js App Router 中通过 fetchRequestHandler 创建 API 路由;用 createTRPCReact 创建客户端;在组件中使用 useQuery、useMutation 等。

适用场景:需要前后端共享类型、减少手写接口类型与校验的 TypeScript 全栈项目,尤其是 Next.js 应用。

限制:资料未提供收费、价格、平台支持范围、性能数据或与其他方案的对比;订阅、服务端调用等部分示例未完整展开,实际实现需参考官方文档。