进阶 trpc.io 2026-10-12 05:42:24 · 29 阅读

第8章 Express 适配器

Version: 11.x Express 适配器 示例应用 描述 链接 在 Node.js 中使用 Express 服务器和过程调用 CodeSandbox 源码 如何在现有 Express 项目中接入 tRPC 1. 安装依赖 bash yarn add @trpc/server zod Zod 并非必需依赖,但下面的示例 router 中会用到。 AI Agents 如果你使用 AI 编程助手,可以安装 tRPC skills 以获得更好的代码生成效果: bash npx @tanstack/intent@latest install 2. 创建 tRPC router 实现你的 tRPC router,示例如下: server.ts ts import { initTRPC } from '@trpc/server'; import { z } from 'zod'; export const t = initTRPC.create(); export const appRouter = t.router({ getUser: t.procedure.input(z.string()).query((opts) => { opts.input; // string return { id: opts.input, name: 'Bilbo' }; }), createUser: t.procedure .input(z.object({ name: z.string().min(5) })) .mutation(async (opts) => { // use your ORM of choice return { id: '1', ...opts.input }; }), }); // export type definition of API export type AppRouter = typeof appRouter; 如果 router 文件变得过大,可以把它拆分成多个子 router,分别放在各自的文件里,再合并成一个根 appRouter。 3. 使用 Express 适配器 tRPC 内置了 Express 适配器,可以把你的 tRPC router 转换成 Express 中间件。 server.ts ts import { initTRPC } from '@trpc/server'; import * as trpcExpress from '@trpc/server/adapters/express'; import express from 'express'; // created for each request const createContext = ({ req, res, }: trpcExpress.CreateExpressContextOptions) => ({}); // no context type Context = Awaited>; const t = initTRPC.context().create(); const appRouter = t.router({ // [...] }); const app = express(); app.use( '/trpc', trpcExpress.createExpressMiddleware({ router: appRouter, createContext, }), ); app.listen(4000); 现在你的端点已经可以通过 HTTP 访问了! 端点 HTTP URI getUser GET http://localhost:4000/trpc/getUser?input=INPUT

其中 INPUT 是一个 URI 编码的 JSON 字符串。使用 POST 方法请求 http://localhost:4000/trpc/createUser ,其 req.body 类型为 {name: string}。

评论 (0)