Опубликовано в Профессии

Какие тесты нужны маленькому backend-сервису

Фигурка рассматривает через лупу трещину в прозрачном колесе рядом с машинкой без одного колеса.

Время чтения: 5 мин.

Маленькому backend-сервису нужен набор тестов, который обнаруживает значимые нарушения его поведения. Начни с последствий: потерянная запись, чужие данные, лишнее списание или успешный ответ после сбоя. Затем выбери самый простой уровень проверки, на котором соответствующая ошибка действительно проявится.

Разберём учебный сервис бронирования переговорных. Пользователь выбирает комнату и время, создаёт бронь и может её отменить. Нам нужно проверить правила пересечений, запись в базу и HTTP-контракт. В примерах ниже нет требования покрыть всё одинаковым числом тестов: количество зависит от правил и возможных отказов.

Составь список рисков по пользовательским действиям

Выпиши основные операции и то, что может пойти не так. Для создания брони это неправильный интервал, пересечение с другой бронью, отсутствие прав и недоступная база. Для отмены добавятся чужая запись и повторный запрос к уже отменённой броне.

Рядом с каждым риском запиши наблюдаемый результат. «Правильно обрабатывается ошибка» слишком неопределённо. «После отклонённого пересечения в базе нет новой брони, а клиент получает согласованный ответ» уже задаёт подготовку и проверку.

Не начинай с перечня всех приватных функций. Внутренние функции меняются вместе с устройством решения, а пользовательские ограничения могут сохраняться. Если тест связан с риском, будет проще понять, почему он нужен после рефакторинга.

Выбери несколько последствий с наибольшей ценой для проекта. Это рабочая редакционная приоритизация, а не универсальная оценка риска в баллах. Для личного учебного сервиса и системы с реальными платежами список существенных отказов будет различаться.

Рука опускает синий шар в круглое отверстие белого сортировщика форм, рядом лежит синий куб.

Проверь чистые правила без сети и базы

Проверку временного интервала удобно выделить в функцию, которая получает данные и возвращает результат. Для неё подготовь корректный случай, равные границы, обратный порядок и выбранные пограничные значения. Часовой пояс и переход даты учитывай в той форме, в какой они существуют в контракте проекта.

Официальный учебник Go по тестированию показывает базовый тест и запуск через go test. На этом уровне важны понятные входы и точное ожидание. Дополнительный HTTP-сервер не поможет проверить простое правило, если оно уже выражено отдельно.

Содержательные названия сценариев помогают читать сбой. «Интервал начинается после окончания» объясняет причину лучше номера случая. Если возникает несколько похожих условий, их можно объединить общей подготовкой, сохранив различимые ожидания.

Материал Go о subtests показывает средства организации отдельных сценариев внутри теста. Используй их, когда это упрощает запуск и диагностику. Общая обвязка не должна скрывать, какие данные получает проверяемая функция и почему ожидается именно такой результат.

Две фигурки с разных сторон книжного шкафа протягивают друг другу синюю книгу.

Проверь настоящую границу с базой

Отдельная проверка нужна там, где результат зависит от SQL, ограничений схемы или транзакции. Подготовь две пересекающиеся брони и убедись, что сохраняется выбранное правило. Подмена хранилища заранее заданным ответом не проверит фактический запрос к базе.

Используй ту же систему управления базой, которая выбрана для приложения, в изолированном тестовом окружении. Применяй настоящие миграции и не оставляй неявной зависимости от таблиц, созданных вручную. Так проверка сможет обнаружить расхождение между кодом и схемой.

Для каждой проверки подготовь собственные данные с ясными отношениями. Случайный общий пользователь и одна комната на весь набор делают параллельный запуск источником странных отказов. Изоляция может быть устроена по-разному; важно, чтобы тест не зависел от результата предыдущего.

После ошибки проверяй состояние данных. Если операция меняет несколько записей, недостаточно увидеть error у вызывающей функции. Нужно убедиться, что недопустимая часть изменения не осталась сохранённой и следующий корректный запрос может выполниться.

Подтверди HTTP-контракт на выбранных маршрутах

Для нескольких ключевых действий проверь путь через HTTP: метод, маршрут, подготовку входа и ответ. Нужны статус, существенные заголовки и смысл тела. Тест, который просто получает любой ответ без падения, не подтверждает контракт.

В Go пакет httptest помогает исследовать обработчик и поднять тестовый сервер. Выбор зависит от того, проверяешь ли ты сам обработчик или поведение более полного маршрута с промежуточными проверками. Не называй изолированный вызов полной проверкой приложения.

Для сервиса бронирования подготовь создание, получение и запрещённое изменение чужой записи. На вход подай реалистичные минимальные данные, а в ответе проверяй важные поля. Полное побайтовое сравнение ответа может сделать тест зависимым от несущественного форматирования.

Отдельно проверь преобразование внутреннего сбоя в публичную ошибку. Клиент не должен получать строку подключения к базе или внутренний стек. В то же время ошибка не должна превращаться в успешный пустой список, который выглядит как отсутствие броней.

Воспроизведи конкурентность и отказ без случайных пауз

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

Не используй длительную фиксированную паузу как доказательство того, что участники дошли до выбранного места. Лучше иметь сигнал начала работы или другой наблюдаемый барьер. На медленной машине тот же сон может закончиться слишком рано, а на быстрой только замедлит набор.

Для отказа зависимости выбери контролируемый способ: тестовую реализацию, возвращающую известную ошибку, либо управляемое тестовое окружение. Укажи, какое свойство проверяется. Подмена помогает проверить реакцию вызывающего кода, но не доказывает поведение настоящего драйвера.

Если проверка иногда падает, сохрани условия сбоя и разберись с ними до добавления повторных запусков. Автоматический повтор может скрыть проблему изоляции или незавершённой горутины. Надёжность самого теста входит в ценность результата.

Оставь набор небольшим и объяснимым

Для каждого теста попробуй закончить фразу: «Если убрать это правило, проверка обнаружит…». Затем временно измени важное условие и посмотри, действительно ли тест падает. Такой опыт помогает заметить проверки, которые наблюдают лишь отсутствие паники.

Раздели быстрые проверки правил и более дорогие сценарии с настоящими зависимостями. Укажи команды запуска и необходимые условия в README. Другой разработчик должен понимать, какой результат он получает от каждой команды.

После изменения требований обновляй ожидания по смыслу. Если отмена теперь возвращает иной допустимый статус, тест должен отражать новый контракт, а не защищать случайную старую реализацию. На совместный разбор принеси список рисков и соответствующие проверки: так легче найти пропуск без механического увеличения числа тестов.

Собери следующий шаг подготовки

Зарегистрируйся в LMS hitalent бесплатно и посмотри теорию опубликованных курсов и открытые роадмапы. Сопоставь их со своим списком рисков и выбери тему для следующей самостоятельной проверки.

Зарегистрироваться бесплатно