适配器

非官方测试版翻译

本页面由 PageTurner AI 翻译（测试版）。未经项目官方认可。 发现错误？ 报告问题 →

tRPC 本身并不是独立的服务器，因此需要通过其他宿主环境提供服务，例如简单的 Node.js HTTP Server、Express 或 Next.js。无论选择哪种后端，大多数 tRPC 功能都保持一致。适配器充当宿主系统与 tRPC API 之间的桥梁。

适配器通常遵循通用规范，允许你通过 createContext 设置上下文创建逻辑，通过 onError 全局处理错误，更重要的是让你能为应用选择合适的宿主环境。

我们支持多种 API 托管模式，相关文档均可在此查阅。

• 对于传统服务器架构的 API，可以使用 Standalone 适配器，或通过 Express/Fastify 适配器接入现有 API

• 如需无服务器方案，可选择 AWS Lambda 或面向边缘运行时的 Fetch 适配器

• 若使用全栈框架，可选用 Next.js 等深度集成方案，或通过 Fetch 适配器兼容 Next.js/Astro/Remix/SolidStart

技巧

在本地开发或传统服务器架构中，最简单的适配器是 Standalone Adapter，可用于运行标准 Node.js HTTP 服务器。当需要快速启动且无现成 HTTP 服务器时，我们推荐此方案。后续需求变更时也能轻松替换。