Знакомство с Echo: минимализм, который работает

Echo — один из старейших живых веб-фреймворков Go: первые коммиты в репозитории labstack/echo датируются 2012 годом, то есть он старше большинства библиотек, которые вы встретите в этой экосистеме. Автор проекта — Ричард Шнайдер (ник vishr), вокруг которого со временем выросла организация Labstack. Настоящая веха — версия 4, вышедшая в конце 2018-го: с ней появился модульный путь github.com/labstack/echo/v4, и с тех пор API живёт в четвёртой мажорной ветке без ломающих изменений. Для сравнения: Gin стартовал в 2014-м, Fiber — в конце 2019-го. Возраст здесь значит не «древность», а предсказуемость: вопросы со Stack Overflow, статьи и примеры из туториалов семилетней давности почти без правок работают на сегодняшнем Echo — редкое свойство для веб-библиотеки, за которое обычно платят революциями при смене мажора.

Вот ключевая отличительная черта, ради которой стоит читать дальше: сигнатура обработчика — func(c echo.Context) error. В Gin на каждую ошибку вы пишете c.JSON(http.StatusBadRequest, ...) прямо в теле обработчика; в Echo ошибка — это возвращаемое значение. Вернули echo.NewHTTPError(http.StatusBadRequest, "некорректный id") — фреймворк сам превратит её в ответ со статусом 400 и JSON-телом. Вернули обычную ошибку — получите 500 и запись в логе. Вся конвертация живёт в одном месте, HTTPErrorHandler, и его можно заменить своим (детально — в уроке про HTTPError). Это идиоматичнее для Go, где ошибки — часть сигнатуры функций, и заметно сокращает рутину if err != nil в обработчиках. Мне этот стиль нравится больше, чем ручные ответы Gin; но честности ради — на маленьком API разница косметическая, выбирать фреймворк из-за неё не стоит.

Echo и Gin — два самых зрелых фреймворка на net/http, и на бумаге они близнецы: роутер, middleware, привязка данных, совместимость со стандартной библиотекой. Различия всплывают в деталях. В Echo обработчик возвращает error, в Gin отвечает через контекст без возвращаемого значения. echo.Context в Echo — интерфейс, а не структура: его можно расширить или подменить в тестах без хитростей с встраиванием. Роутер Echo на radix-дереве исторически один из самых быстрых; в свежих бенчмарках Gin и Echo ходят рядом, и сильно разойтись им не даёт сам net/http — узкое место реального сервиса почти всегда база данных, а не роутер. По экосистеме и найму Gin крупнее, и это легальный аргумент. Мой водораздел: новый проект, где хочется аккуратного API и централизованных ошибок, — беру Echo; команда с готовым Gin-кодом — не переезжает, миграция ничего не даст. Fiber из этой тройки стоит особняком: он на fasthttp, без полной совместимости с net/http, и его сильные стороны — скорость на простых запросах и Express-привычки для выходцев из Node.js.

Моё правило простое. Берите Echo, когда пишете классический HTTP API на Go, начинаете с чистого листа и хотите, чтобы ошибки шли через return, а не через ручные ответы на каждом шаге. Берите Gin, если в команде уже есть Gin-код или нужные библиотеки — экосистема у него богаче, и переезд ради вкуса никто не оплатит. Не нужны ни тот ни другой, когда это два ручки health-check внутри существующего сервиса — хватит net/http. А если ваши сервисы говорят друг с другом по жёстким контрактам, посмотрите сначала на gRPC: там HTTP+JSON — лишний слой сериализации. Цена ошибки небольшая: и Gin, и Echo построены на net/http, миграция между ними для среднего API — день-два работы. Хуже выбрать fasthttp-стек без понимания, зачем он вам: вот там несовместимость с экосистемой уже реальна, а не теоретична.

Ядро Echo компактно, и часть функциональности сознательно вынесена в соседние репозитории. JWT-аутентификация живёт в отдельном модуле github.com/labstack/echo-jwt/v4 — в ранних версиях она была встроенным middleware.JWT, а в четвёртой версии её вынесли. Организация Labstack держит репозиторий echo-contrib: сессии, Prometheus-метрики, pprof. Валидация — через популярный go-playground/validator: подключаете его к e.Validator, и c.Validate(input) начинает проверять struct-теги (придёт в уроке про валидацию). Документация — на labstack.com/echo, и она разделена по версиям: примеры для v3 читайте с осторожностью, API между мажорами менялся.

Одна оговорка про формат этого курса: песочница сайта исполняет чистый Go без сети, поэтому Echo-код в уроках не запускается в браузере. Чтобы гонять примеры руками, поставьте локальный Go (пять минут по инструкции базового курса) и сделайте go get для зависимостей — покажем всё в следующем уроке.

Во втором уроке поднимем первый сервер: go mod init, echo.New, Logger, Recover и POST-эндпоинт с c.Bind — каждую строку разберём по слогам. В третьем — маршрутизация и параметры: c.Param, c.QueryParam и правило приоритета маршрутов. Дальше binding и валидация, middleware, JWT, тесты и итоговый REST API в финальном уроке. Если Go пока на уровне «читал, но не писал», начните с базового курса: структуры, указатели и ошибки из него понадобятся уже со второго урока. И последнее: тесты, «заполни пропуск» и «собери программу» в каждом уроке дают XP и работают без запуска кода, а примеры копируйте в локальный проект — живые логи настоящего сервера не заменит ни один разбор.