Первый сервер на Echo: от go mod init до живых логов

Первая строка — e := echo.New() — создаёт *echo.Engine: объект, который хранит маршруты, middleware и настройки сервера. Если вы читали урок про Gin: там gin.Default() возвращал движок с уже подключёнными Logger и Recovery. У Echo философия другая — минимализм из теглая доходит и до конструктора: echo.New() даёт голый движок без единого middleware, и вы явно решаете, что подключить. Это чуть многословнее и заметно прозрачнее: увидели e.Use(middleware.Logger()) — знаете, что логи есть; не увидели — их нет. Минимум, который я ставлю в каждый проект, — две строки: Logger и Recover. Recover ловит паники в обработчиках и превращает их в ответ 500 вместо падения всего процесса: без него одна сломанная функция в одном маршруте уронит сервер целиком — а паника в одном из двадцати обработчиков, как показывает практика, случается всегда.

e.GET("/hello", handler) связывает метод GET и путь /hello с функцией. Сигнатура обработчика одна для всех методов: func(c echo.Context) error. echo.Context — это «руль» запроса: через него читают параметры, тело и заголовки (c.Param, c.Bind, c.Request()) и отправляют ответы (c.String, c.JSON, c.HTML). c.String(http.StatusOK, "Привет, Echo!") пишет в ответ строку с Content-Type: text/plain и возвращает ошибку записи, если клиент оборвал соединение, — её вы просто пробрасываете через return, обработкой займётся фреймворк. Для JSON той же логикой работает c.JSON: передаёте статус и данные — map, срез или структуру. Обратите внимание: gin.H в Echo нет, собираете map[string]any или отдельную структуру. На мой взгляд, структура честнее — она фиксирует формат ответа компилятором, и переименование поля ломает сборку, а не продакшен.

Последняя строка — e.Logger.Fatal(e.Start(":8080")) — на первый взгляд перегружена, но каждый кусочек по делу. e.Start(":8080") внутри — это обёртка над http.ListenAndServe: сервер начинает слушать порт и блокирует выполнение до остановки; в консоль при этом падает строка «⇨ http server started on :8080». Start возвращает error, если запуститься не удалось — скажем, порт занят другим процессом. Именно поэтому Start оборачивают в e.Logger.Fatal: он печатает ошибку и завершает процесс с ненулевым кодом выхода. Без Fatal ошибка уйдёт в никуда: программа продолжит работать дальше по main() и «вежливо» завершится, а вы будете смотреть на пустой терминал, за которым никакого сервера нет. Тот же Fatal-стиль вы увидите в Gin и Fiber — это общий паттерн Go для запуска: ошибка старта означает, что продолжать нечего.

Запустите go run . и откройте http://localhost:8080/hello — увидите приветствие. Сразу после старта Echo рисует ASCII-баннер с версией, а при каждом запросе middleware.Logger дописывает строку в терминал. Свежие версии (с v4.10) по умолчанию пишут лог одной JSON-строкой; сокращённо она выглядит так:

{"time":"...","level":"INFO","prefix":"echo","remote_ip":"127.0.0.1","method":"GET","uri":"/hello","status":200,"latency_human":"...","bytes_out":24}

Отсюда берут всё при отладке: remote_ip — кто пришёл, method и uri — что и куда запросил, status — что ответили, latency_human — сколько обрабатывали. Поле uri особенно полезно, когда ловите опечатку в пути: запрос, который вы считали /users/42, а на самом деле это /user/42, в логе виден мгновенно. Тот же запрос из терминала — curl -v http://localhost:8080/hello — покажет и заголовки ответа, чего браузер не всегда делает удобно.

Следующий урок — маршрутизация и параметры: path-параметры :id, query-параметры и приоритет маршрутов. Потом научимся работать с телом и заголовками (запросы и ответы), писать собственные middleware (цепочки middleware) и структурировать ошибки через HTTPError и свой ErrorHandler. Если сравнить этот main.go с gin-версией из курса Gin, разница уместится в две-три строки — и это хороший повод прочитать оба, чтобы выбрать фреймворк осознанно.