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