Как протестировать обработчики HTTP?

Обработчики HTTP в Go тестируются изолированно, без реального сетевого сокета, с использованием httptest. Цель — протестировать контракт уровня HTTP: статус, заголовки, тело ответа, обработку ошибок и пограничные сценарии.

Канонический подход:

1. Создайте запрос через httptest.NewRequest(...).

2. Создать рекордер через httptest.NewRecorder().

3. Обработчик вызова: handler.ServeHTTP(rec, req).

4. Проверьте:

• rec.Code (код состояния);

• заголовки;

• тело (JSON/схема/сообщение).

Что должно быть покрыто:

1. Счастливый путь (правильный запрос, ожидаемый ответ).

2. Ошибки проверки (неполные/неверные полезные данные, параметры запроса).

3. Методы HTTP (GET/POST/PUT/DELETE + 405, если метод не разрешен).

4. Ошибки зависимостей (сервис/репозиторий возвращает ошибку).

5. Контекстные скрипты (таймаут/отмена, если логика это поддерживает).

Архитектурные советы:

1. Экспортируйте бизнес-логику из обработчика на уровень сервиса.

2. В тестах обработчиков моделируйте/подделывайте зависимости сервисов.

3. Тестируйте сам HTTP-контракт, а не внутреннюю реализацию.

Практический минимум проверок:

1. Исправьте Content-Type.

2. Структура ответа JSON.

3. Соответствие кодов статуса ошибкам домена.

4. Отсутствие утечки конфиденциальной информации в теле ошибки.

Заключение:

Тест HTTP-обработчика в Go — это проверка поведения конечной точки как черного ящика: входящий запрос → очистить вывод HTTP. httptest предоставляет быстрый, детерминированный и достаточно точный инструмент для такого тестирования контрактов.

Пример:

Итог

Обработчики HTTP в Go тестируются изолированно, без реального сетевого сокета, с использованием httptest.