tRPC в продакшне
tRPC даёт типобезопасный API без OpenAPI и кодогенерации. В монорепо TS — отличная штука. В микросервисах — нет.
tRPC — способ писать API без отдельного описания контракта (OpenAPI, Swagger) и без кодогенерации. Вы объявляете процедуру на сервере, а клиент получает её типы напрямую через TypeScript: поменяли поле в ответе — фронтенд сразу подсветит все места, где оно используется. В подходящем проекте это заметно ускоряет разработку. В неподходящем — создаёт проблемы, которые всплывают через полгода. Разберём, где проходит граница.
Как это выглядит
На сервере описывается роутер с процедурами. Входные данные валидируются схемой (обычно Zod), тип ответа выводится из кода:
export const appRouter = router({
orderById: publicProcedure
.input(z.object({ id: z.string() }))
.query(({ input }) => db.order.find(input.id)),
});
export type AppRouter = typeof appRouter;
Клиент импортирует только тип AppRouter и вызывает процедуру как функцию. Никаких ручных интерфейсов для ответа, никаких рассинхронизаций между бэком и фронтом.
Когда tRPC сильно помогает
- Монорепозиторий, где фронтенд и бэкенд пишет одна команда, а часто одни и те же люди.
- Full-stack приложения на Next.js или похожих фреймворках.
- Внутренние инструменты: админки, кабинеты, панели — без внешних потребителей API.
- Быстрые итерации на старте продукта, когда контракт меняется каждую неделю.
В таких проектах tRPC убирает целый слой работы: не нужно поддерживать описание API, генерировать клиент и следить, чтобы всё это совпадало с реальностью.
Когда tRPC не подходит
- API потребляет кто-то кроме вашего веб-фронтенда: нативное мобильное приложение, партнёры, публичный SDK.
- Фронтенд и бэкенд делают разные команды с разными циклами релизов.
- Бэкенд написан не на TypeScript.
- Микросервисы, которые разрабатывают и деплоят независимо друг от друга.
Вся ценность tRPC — в общих типах. Если общей кодовой базы нет, остаётся RPC-протокол без стандартной документации.
Что часто упускают
- Это RPC, а не REST. Процедуры вместо ресурсов, свои соглашения об ошибках и кэшировании. Если в команде устоялись REST-конвенции, переход меняет привычную семантику.
- Версионирование не из коробки. Типы на клиенте и сервере должны совпадать. Если клиент — веб, который деплоится вместе с сервером, проблем нет. Если есть старые клиенты, которые обновляются не сразу, придётся самим поддерживать обратную совместимость.
- Документация. Для внешних потребителей нет стандартного описания вроде OpenAPI. Существуют сторонние адаптеры, но это надстройка, а не основной сценарий.
- Скорость проверки типов. На очень больших роутерах TypeScript в редакторе начинает заметно тормозить. Помогает разбиение на вложенные роутеры и аккуратная работа с выводом типов.
Практика в продакшне
- Валидация на входе обязательна. Типы TypeScript исчезают при компиляции, а данные от клиента могут быть любыми. Схема Zod на каждой процедуре — не формальность.
- Авторизация через middleware. Создайте отдельный тип процедуры, например
protectedProcedure, который проверяет сессию, — и используйте его везде, где нужны права. - Ошибки. Возвращайте осмысленные коды и не отдавайте клиенту внутренние детали и стектрейсы.
- Логирование и мониторинг. Добавьте middleware, которое логирует имя процедуры, время выполнения и ошибки. Без этого искать медленные запросы сложно.
- Batching. Клиент умеет объединять несколько запросов в один HTTP-вызов. Удобно, но учитывайте это при настройке лимитов и кэша на прокси.
Если tRPC уже в проекте, а требования поменялись
Бывает, что внутренний инструмент на tRPC вырастает, и появляется мобильное приложение или партнёр, которому нужен API. Переписывать всё не обязательно: можно оставить tRPC для веб-фронтенда, а для внешних потребителей сделать отдельный REST-слой поверх тех же сервисных функций. Главное — держать бизнес-логику в отдельных модулях, а не внутри процедур, тогда второй транспорт добавляется без дублирования кода.
Как решить: короткий чек-лист
- Бэкенд и фронтенд на TypeScript в одном репозитории? Если нет — tRPC не для вас.
- Есть или планируются внешние потребители API? Если да — REST с OpenAPI или GraphQL.
- Одна команда отвечает за обе стороны? Если да — tRPC даст выигрыш в скорости.
- Есть клиенты, которые обновляются независимо от сервера? Если да — продумайте совместимость заранее.
Если у вас Next.js, один продукт и одна команда, tRPC — отличный выбор. В остальных случаях обычно проще и надёжнее REST с описанием в OpenAPI. Про связанный стек — в статье о Next.js в продакшне, а выбрать архитектуру под задачу поможем при разработке веб-приложения.
Выбираете стек для нового продукта и сомневаетесь в tRPC — напишите в Telegram или MAX.