tRPC в продакшне

tRPC даёт типобезопасный API без OpenAPI и кодогенерации. В монорепо TS — отличная штука. В микросервисах — нет.

tRPC в продакшне

tRPC — способ писать API без отдельного описания контракта (OpenAPI, Swagger) и без кодогенерации. Вы объявляете процедуру на сервере, а клиент получает её типы напрямую через TypeScript: поменяли поле в ответе — фронтенд сразу подсветит все места, где оно используется. В подходящем проекте это заметно ускоряет разработку. В неподходящем — создаёт проблемы, которые всплывают через полгода. Разберём, где проходит граница.

tRPC в продакшне
tRPC — нишевый инструмент, отлично для одного, никак для другого.

Как это выглядит

На сервере описывается роутер с процедурами. Входные данные валидируются схемой (обычно 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-слой поверх тех же сервисных функций. Главное — держать бизнес-логику в отдельных модулях, а не внутри процедур, тогда второй транспорт добавляется без дублирования кода.

Как решить: короткий чек-лист

  1. Бэкенд и фронтенд на TypeScript в одном репозитории? Если нет — tRPC не для вас.
  2. Есть или планируются внешние потребители API? Если да — REST с OpenAPI или GraphQL.
  3. Одна команда отвечает за обе стороны? Если да — tRPC даст выигрыш в скорости.
  4. Есть клиенты, которые обновляются независимо от сервера? Если да — продумайте совместимость заранее.

Если у вас Next.js, один продукт и одна команда, tRPC — отличный выбор. В остальных случаях обычно проще и надёжнее REST с описанием в OpenAPI. Про связанный стек — в статье о Next.js в продакшне, а выбрать архитектуру под задачу поможем при разработке веб-приложения.

Выбираете стек для нового продукта и сомневаетесь в tRPC — напишите в Telegram или MAX.

Webhooks-шлюз
Услуга по теме — обсудим ваш проект.

Есть задача по теме? Напишите — вернёмся с оценкой и сроками.

Написать в Telegram → Написать в MAX