Реализация Middleware для сквозной функциональности
В предыдущей теме мы разобрали роутер в Go 1.22+ и научились регистрировать хендлеры. В реальных проектах возникают сквозные задачи: логирование, проверка авторизации или обработка паник. Если копировать этот код в каждый хендлер, проект станет невозможно поддерживать.
Для таких задач используют паттерн Middleware. Если вы писали на React, то уже знакомы с этой концепцией через компоненты высшего порядка (HOC) или Middleware в Redux. В Go это функции, которые принимают http.Handler и возвращают новый, «обернутый» http.Handler.
Анатомия Middleware
В Go функции — это объекты первого класса. Их можно передавать как аргументы и возвращать из других функций. Процесс создания такой обертки называется Handler wrapping.
На Схеме 1 показано, как запрос проходит через слои Middleware до бизнес-логики и возвращается обратно.
Стандартная сигнатура Middleware: func(http.Handler) http.Handler.
Реализуем Middleware для логирования времени запроса. Мы используем замыкание, чтобы вернуть функцию, которая соответствует интерфейсу http.Handler.
func Logger(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
start := time.Now()
// Передаем управление следующему звену
next.ServeHTTP(w, r)
// Выполнится, когда хендлер закончит работу
log.Printf("%s %s %v", r.Method, r.URL.Path, time.Since(start))
})
}Цепочки вызовов (Chaining)
Когда Middleware становится много, их выстраивают в последовательность. Этот процесс называется Chaining. В Go 1.22+ Middleware можно применять ко всему серверу или к группам маршрутов.
Ручное вложение функций делает код нечитаемым:
// Плохо: «ад» из скобок
mux.Handle("/api/users", Logger(Auth(Recover(usersHandler))))Чтобы избежать нагромождения, используют функции-конструкторы или сторонние библиотеки (например, chi.Chain). Помните: Middleware выполняются в порядке «оборачивания» — внешние слои срабатывают первыми.
Восстановление после сбоев (Recovery)
Если в хендлере случится panic (например, из-за обращения к nil), без защиты упадет весь сервер. Middleware для восстановления использует defer и recover.
Middleware, который перехватывает панику и отдает клиенту 500 ошибку:
func Recovery(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
defer func() {
if err := recover(); err != nil {
log.Printf("Паника: %v", err)
http.Error(w, "Internal Server Error", http.StatusInternalServerError)
}
}()
next.ServeHTTP(w, r)
})
}Передача данных через Context
Middleware для авторизации часто извлекает ID пользователя из токена. Чтобы передать этот ID в хендлер, используйте r.Context(). Это похоже на React Context, но работает только в рамках одного HTTP-запроса 🧩
type contextKey string
const userIDKey contextKey = "userID"
// В Middleware:
ctx := context.WithValue(r.Context(), userIDKey, 42)
next.ServeHTTP(w, r.WithContext(ctx))
// В хендлере:
userID, ok := r.Context().Value(userIDKey).(int)
Реализуйте Middleware HeaderCheck. Он должен проверять заголовок X-App-Token. Если заголовка нет или он пуст — верните ошибку 403 Forbidden через http.Error и не вызывайте next.ServeHTTP. Если заголовок на месте — пропустите запрос дальше.
Мы научились делать сервисы надежными с помощью Middleware. Но данные в памяти живут недолго. Чтобы приложение приносило пользу, нужно сохранять информацию на диске.
В следующей теме мы перейдем к работе с персистентностью: изучим PostgreSQL, драйвер pgx и управление пулом соединений.