Перейти к содержимому
Учи.Онлайн Выбрать школу
Статья

gRPC и Protobuf для бэкендера: контракт сервиса, кодогенерация и отличие от REST

gRPC — способ вызывать методы другого сервиса так, будто это функция в вашем коде, а Protobuf — язык, на котором описывают эти методы и сообщения, и компактный двоичный формат для их передачи. Бэкендер пишет файл .proto с сервисом и типами данных, генерирует по нему клиент и сервер для своего языка, реализует методы, задаёт дедлайны и коды ошибок, подключает interceptors для логов и авторизации. Кроме того, придётся освоить правила эволюции схемы, балансировку долгих соединений HTTP/2, REST-фасад через grpc-gateway и инструменты grpcurl и buf.

Автор: редакция Учи.ОнлайнОтветственный редактор: Дмитрий Игнатьев
Содержание
Иллюстрация к статье: gRPC и Protobuf для бэкендера: контракт сервиса, кодогенерация и отличие от REST

Частое заблуждение — считать gRPC «быстрым REST с двоичным JSON». На деле меняется модель: вместо ресурсов и HTTP-методов у сервиса список процедур с типизированными аргументами, а договор между командами хранится не в вики, а в файле, из которого собирается код. Обратная сторона — менять контракт приходится по правилам: один повторно использованный номер поля портит данные тише, чем любая ошибка 500.

Как устроен вызов

gRPC работает поверх HTTP/2: одно соединение несёт много параллельных вызовов, у каждого свои метаданные и итоговый статус. В теле сообщения Protobuf нет имён полей, только номера и значения, поэтому оно короче JSON, но глазами его не прочитать. gRPC уместен для вызовов между внутренними сервисами, для своих мобильных приложений и потоковых данных. Браузеру нужен gRPC-Web с прокси или REST-фасад, а публичный API для сторонних разработчиков обычно остаётся на REST.

Контракт в .proto и кодогенерация

Пример учебный. Магазину нужно узнавать остаток товара на складе и получать изменения, пока покупатель смотрит карточку. Команда склада описывает сервис:

syntax = "proto3";
package warehouse.v1;

service StockService {
  rpc GetStock(GetStockRequest) returns (Stock);
  rpc WatchStock(WatchStockRequest) returns (stream Stock);
}

message GetStockRequest { string sku = 1; }
message WatchStockRequest { repeated string skus = 1; }

message Stock {
  string sku = 1;
  int32 quantity = 2;
  optional int32 reserved = 3;
}

Числа после знака равенства — номера полей: в сообщение попадают они, а не имена. Версия v1 в имени пакета позволяет выпустить несовместимую переделку как v2 рядом со старой. Слово optional отличает «резерва нет» от нуля: у обычного скалярного поля proto3 после разбора не видно, передали 0 или поле отсутствовало.

Код генерирует компилятор protoc с плагинами, для Go это protoc-gen-go и protoc-gen-go-grpc. Склад реализует интерфейс StockServiceServer, а команда заказов вызывает client.GetStock(ctx, req) как обычную функцию. Сгенерированные файлы руками не правят, их пересоздают при каждом изменении схемы.

Четыре типа вызовов

Unary — один запрос и один ответ, как GetStock. Server streaming — один запрос и поток ответов: WatchStock присылает остаток при каждом изменении, пока клиент не закроет вызов. Client streaming — поток запросов и один итог, например загрузка показаний датчиков. Bidirectional streaming — два независимых потока, как в чате. Потоки дороже в эксплуатации: прокси рвут долгие соединения по тайм-ауту простоя, клиент должен переподключаться и не терять события. Если данные нужны раз в минуту, unary-вызов по расписанию проще.

Как менять схему и не сломать соседей

Правила собраны в разделе «Updating A Message Type» руководства по proto3 на protobuf.dev. Добавлять поля и значения enum безопасно: старый код пропустит незнакомое поле. Удалённое поле вносят в reserved по номеру и имени, потому что номер нельзя использовать повторно. Менять номер существующего поля нельзя, номера 19 000–19 999 заняты самой библиотекой, а 1–15 кодируются одним байтом.

Менее известны две оговорки той же страницы. Типы int32, uint32, int64, uint64 и bool совместимы на проводе, но 64-битное число, прочитанное как int32, усекается до 32 бит, как при приведении типов в C++, — без ошибки. Склад перевёл quantity на int64, остаток превысил 2 147 483 647 — старый клиент покажет бессмысленное число. Вторая оговорка: незнакомые поля сохраняются при пересылке двоичного сообщения, но теряются при сериализации в JSON. Посредник, которого не пересобрали после добавления поля и который отдаёт сообщение через REST-фасад или пишет в лог JSON, молча отрежет новое поле. А для сообщений, хранимых в ProtoJSON, важно имя поля, и переименование, безобидное для двоичного формата, ломает разбор.

Вручную это не проверяют. Команда buf breaking --against '.git#branch=main' сравнивает схему с основной веткой и падает на несовместимом изменении. По документации buf, по умолчанию действует самая строгая категория FILE; WIRE проверяет только двоичный формат, а WIRE_JSON — ещё и JSON, её выбирают при REST-фасаде.

Дедлайны, коды ошибок и interceptors

По руководству gRPC о дедлайнах, библиотека сама дедлайн не задаёт, и клиент без него может ждать бесконечно. Поэтому каждый вызов получает предел:

ctx, cancel := context.WithTimeout(ctx, 300*time.Millisecond)
defer cancel()
_, err := client.GetStock(ctx, req)
if status.Code(err) == codes.DeadlineExceeded { /* остаток из кэша */ }

Вместо HTTP-кодов у gRPC 17 статусов, они перечислены в справке о кодах статуса. Семь из них, в том числе INVALID_ARGUMENT, NOT_FOUND и FAILED_PRECONDITION, библиотека не создаёт: их выбирает ваш код, и от выбора зависит поведение клиента. UNAVAILABLE — временный сбой, который лечится повтором с паузой, но только для идемпотентных операций. FAILED_PRECONDITION просит не повторять, пока состояние системы не исправят.

Interceptors оборачивают каждый вызов, как middleware в HTTP-фреймворке: проверяют токен из метаданных, пишут лог с кодом и длительностью, собирают метрики. Для unary- и streaming-вызовов интерфейсы разные, и interceptor только для unary потоковые методы пропустит.

Балансировка, grpc-gateway и отличие от REST

HTTP/2 держит соединение долго, поэтому балансировщик уровня TCP распределяет соединения, а не вызовы, и весь трафик клиента уходит в один под. Помогает балансировка на клиенте — в gRPC-go по умолчанию pick_first, для равномерной нагрузки включают round_robin с адресами из headless-сервиса Kubernetes — или прокси уровня L7 вроде Envoy. Для браузера и партнёров ставят grpc-gateway: к методу добавляют аннотацию google.api.http с путём GET /v1/stock/{sku}, и сгенерированный прокси переводит JSON в gRPC. Отлаживать вызовы вручную помогает grpcurl, которому нужен файл .proto или включённый на сервере reflection.

REST удобнее, когда важны кэш на CDN и доступ из любого инструмента, GraphQL — когда у одних данных много экранов с разными полями. Сильные стороны gRPC — строгий контракт между сервисами, генерация кода, потоки и дедлайны в протоколе. Часто подходы сочетают: gRPC внутри, REST или GraphQL снаружи.

С чего начать и в каком порядке осваивать

Порядок идёт от формата данных к эксплуатации: без понимания номеров полей правила совместимости кажутся магией, без работающего unary-сервиса не на чем проверять дедлайны, а балансировка нужна, когда сервис уже отвечает. Нужны уверенный язык бэкенда, основы HTTP и понимание отмены операций, в Go — пакета context.

  1. Protobuf без gRPC: опишите сообщение, сгенерируйте код, посмотрите байты.
  2. Unary-сервис склада и вызов через grpcurl.
  3. Дедлайны, осмысленные коды статуса, interceptor для логов.
  4. Server streaming с обработкой отмены.
  5. buf breaking в CI, grpc-gateway, балансировка в Kubernetes.

Упражнения и типичные ошибки

Пример со складом удобно ломать нарочно. Удалите поле reserved, не записав строку reserved 3;, добавьте поле с номером 3 другого типа и посмотрите, что прочитает старый клиент. Пошлите в int64-поле число больше двух миллиардов клиенту со схемой int32. Добавьте на сервер секундную задержку и проверьте, что клиент получает DEADLINE_EXCEEDED, а сервер прекращает работу после отмены. Типичные ошибки: вызовы без дедлайна, один INTERNAL на все случаи, повтор неидемпотентной операции, тесты только новой версии клиента с новой версией сервера.

В программах по Go gRPC обычно стоит рядом с кодогенерацией. На курсе Яндекс Практикума «Продвинутый Go-разработчик» gRPC идёт в одном списке тем с дженериками и кодогенерацией, а практика строится на проектах: сокращатель ссылок или сервис метрик, затем API программы лояльности и менеджер паролей. Срок — шесть месяцев, есть код-ревью и ментор; на входе ждут основ Go, HTTP, Git и SQL.

Чему учат на курсах

Отдельного онлайн-курса только по gRPC поиск по каталогу Учи.Онлайн не находит: тема входит модулем в программы по Go. Смотрите на практику: пишете ли вы свой .proto, есть ли стриминг, дедлайны и изменение схемы.

На курсе Merion Academy «Go-программист с нуля» одиннадцать блоков, девятый называется «API и gRPC», за ним идут PostgreSQL, архитектура и финальный проект. Обучение асинхронное, около четырёх месяцев по 2–5 часов в неделю. Содержание блока на странице не раскрыто, protobuf не упомянут, проверка — на тестах и лабораторных, поэтому программу блока и цену уточните у школы.

Новичку, которому важны наставник и командная работа, нужна программа длиннее, где gRPC появляется вместе с брокером и несколькими сервисами.

Так устроен курс Kata Academy «Go-разработчик»: девять месяцев от 20 часов в неделю, модуль Go Advanced на четыре недели с микросервисами, Kafka и gRPC, затем командный проект под руководством тимлида. Это вариант с постоплатой: первый платёж 139 000 ₽ не возвращается, затем 20 % зарплаты в течение года после трудоустройства. Protobuf на странице не назван, условия договора прочитайте до оплаты.

Как навык влияет на доход

gRPC почти никогда не бывает отдельной должностью: это строка в требованиях к бэкендерам на Go, Java, C# и других языках. В калькуляторе зарплат Хабр Карьеры в середине октября 2026 года по специалистам с навыком gRPC значится 267 083 ₽ по 67 анкетам — все регионы и уровни вместе, период и вид показателя не указаны. Это анкеты, а не вакансии, и выборка мала. Платят за задачи: контракты, которые меняются без поломок, сервисы под нагрузкой, потоковые API. Посмотрите вакансии своего уровня: стоит ли gRPC в обязательных требованиях или в пожеланиях.

Как выбрать обучение

Перед оплатой проверьте, есть ли в программе собственный .proto, стриминг, коды статуса, правила изменения схемы и проект из нескольких сервисов. Сравнить школы по формату и поддержке поможет рейтинг онлайн-школ с обучением Go: он охватывает язык целиком, так что программы с gRPC отбирайте по описанию. А до оплаты соберите сервис склада и прогоните buf breaking на своей правке схемы — если понятно, почему он ругается, база для курса есть.