Перейти к содержимому
Учи.Онлайн Выбрать школу
Статья

Mockito: моки в юнит-тестах на Java и Kotlin — когда они помогают, а когда мешают

Mockito — библиотека для Java и Kotlin на JVM, которая подменяет зависимости тестируемого класса управляемыми двойниками. Разработчик создаёт мок репозитория или платёжного клиента, задаёт ему ответ через when(...).thenReturn(...), вызывает метод сервиса и проверяет через verify(...), что деньги ушли и письмо отправлено, а ArgumentCaptor перехватывает переданный объект. Так сервисный слой тестируют за миллисекунды без базы данных и сети. Мешают моки, когда подменяют всё подряд и проверяют порядок вызовов вместо результата. До Mockito нужны уверенная Java и JUnit 5.

Автор: редакция Учи.ОнлайнОтветственный редактор: Дмитрий Игнатьев
Содержание
Иллюстрация к статье: Mockito: моки в юнит-тестах на Java и Kotlin — когда они помогают, а когда мешают

Самое частое заблуждение — «чем больше моков, тем чище изоляция». Представьте тест, где подменены все шесть зависимостей сервиса, а последняя строка проверяет порядок их вызовов. Любой рефакторинг, даже не меняющий поведения, роняет такой тест, и команда перестаёт ему доверять. Подменять стоит то, что работает медленно, даёт непредсказуемый результат или оставляет следы во внешнем мире: репозиторий, HTTP-клиент, отправку писем. Объекты-значения вроде суммы заказа честнее создавать настоящими.

Что делает Mockito и чем он отличается от JUnit

JUnit запускает тесты и сравнивает результат с ожидаемым, а Mockito только изготавливает двойников. Мок (mock(...) или поле с @Mock) — пустая оболочка: каждый незастабленный метод возвращает значение по умолчанию — null, ноль, false, пустую коллекцию или пустой Optional. Шпион (spy(...), @Spy) оборачивает настоящий объект и вызывает его реальные методы, кроме тех, которым задан ответ.

У шпиона есть ловушка: запись when(spy.get(0)).thenReturn("x") сначала вызывает настоящий get(0), и на пустом списке тест падает ещё до создания стаба. Для шпионов пишут в обратном порядке: doReturn("x").when(spy).get(0). А если шпион понадобился, чтобы подменить метод внутри тестируемого класса, класс, скорее всего, делает слишком много.

С JUnit 5 библиотеку связывает артефакт mockito-junit-jupiter: @ExtendWith(MockitoExtension.class) создаёт моки для полей с @Mock, перехватчики для @Captor и собирает объект из @InjectMocks. С последней аннотацией осторожнее: по документации Mockito библиотека не сообщает, если внедрить моки не удалось. Явный вызов конструктора в тесте надёжнее и сразу показывает, сколько зависимостей у класса.

Учебный пример: сервис возврата денег

Ситуация учебная. Магазин возвращает деньги, если с покупки прошло не больше 14 дней. RefundService зависит от репозитория заказов, платёжного шлюза, уведомлений и часов java.time.Clock:

@ExtendWith(MockitoExtension.class)
class RefundServiceTest {
    @Mock OrderRepository orders;
    @Mock PaymentGateway payments;
    @Mock Notifier notifier;
    @Captor ArgumentCaptor<Refund> refund;

    @Test
    void refundsWithinFourteenDays() {
        var clock = Clock.fixed(Instant.parse("2026-10-15T10:00:00Z"), ZoneOffset.UTC);
        var service = new RefundService(orders, payments, notifier, clock);
        when(orders.findById(42L)).thenReturn(Optional.of(order(42L, "2026-10-05", 1990)));

        service.refund(42L);

        verify(payments).refund(refund.capture());
        assertEquals(1990, refund.getValue().amountRub());
        verify(notifier).refundIssued(42L);
    }
}

Часы не замоканы: Clock.fixed — настоящий объект с замороженным временем. Вызов findById не проверяется через verify: документация Mockito называет проверку застабленного вызова обычно избыточной — без заказа тест и так упадёт. Проверяются только действия с последствиями: возврат нужной суммы и уведомление. Второй тест берёт заказ двадцатидневной давности, ждёт исключение через assertThrows и заканчивается строкой verifyNoInteractions(payments).

Строгие стабы: почему падает «рабочий» тест

MockitoExtension по умолчанию работает в режиме STRICT_STUBS. Если стаб ни разу не пригодился коду, тест падает с UnnecessaryStubbingException. Если код вызвал застабленный метод с другими аргументами, скажем findById(43L), вы получите PotentialStubbingProblem вместо загадочного null тремя слоями ниже.

Типичная реакция — включить Strictness.LENIENT на весь класс, и это худший выход: лишние стабы остаются и через полгода вводят читателя в заблуждение. Правильнее удалить ненужный стаб или, если он живёт в общем @BeforeEach, пометить только его: lenient().when(...).

Mockito 5, static и final: что сломается на новых JDK

В Mockito 5.0, вышедшем в январе 2023 года, минимальной стала Java 11, а inline-механизм создания моков — основным: final-классы, статические методы и конструкторы подменяются без отдельного артефакта mockito-inline. Статический мок создают через mockStatic(...) в try-with-resources: он действует в текущем потоке и должен быть закрыт, иначе подмена утечёт в следующие тесты.

У этого удобства есть цена. Inline-механизм работает через Java-агент, которого Mockito подключает к уже запущенной JVM. С JDK 21 по JEP 451 такая загрузка сопровождается предупреждением «Dynamic loading of agents will be disallowed by default in a future release»: в одной из следующих версий JDK она будет запрещена по умолчанию и закончится исключением. Поэтому в разделе 0.3 документации Mockito для Java 21+ описана явная настройка: в Maven maven-dependency-plugin находит путь к jar-файлу mockito-core, и он передаётся через -javaagent в argLine плагина Surefire; в Gradle создают конфигурацию mockitoAgent с тем же аргументом для тестовых задач. Предупреждение в логе сегодня — это будущее падение всех тестов с final-классами и mockStatic после обновления JDK.

Возможность подменить статический метод не значит, что ею стоит пользоваться: вместо mockStatic(LocalDate.class) проще передать в класс Clock, как в примере выше.

Spring и Kotlin: где Mockito встречается на практике

Сервисный слой Spring-приложения лучше тестировать вообще без контекста: конструктор, моки, вызов метода. Контекст нужен срезовым тестам вроде @WebMvcTest, где сервис подменяют аннотацией @MockitoBean из Spring Framework 6.2, сменившей @MockBean. Каждый новый набор подменённых бинов поднимает отдельный контекст, и тесты заметно замедляются. О самом фреймворке на сайте есть статья «Spring».

В Kotlin классы по умолчанию final, но Mockito 5 это не мешает. Неудобно другое: when — ключевое слово, его пишут в обратных кавычках или берут обёртку mockito-kotlin с whenever, а для suspend-функций нужны отдельные приёмы. Поэтому в Kotlin-проектах, включая юнит-тесты Android, чаще выбирают MockK: every { repo.find(42) } returns order, coEvery для корутин, verify { ... }. Принципы те же: что подменять и чего не проверять.

С чего начать и в каком порядке осваивать

Порядок выстроен так, чтобы каждый шаг опирался на предыдущий. Без JUnit непонятно, что упало; без внедрения зависимостей моки некуда передать; а static и шпионы, освоенные первыми, приучают тестировать код, который нужно переписать.

  1. JUnit 5: @Test, assertEquals, assertThrows на классах без зависимостей.
  2. Внедрение через конструктор: пусть репозиторий и часы приходят снаружи.
  3. mock, when/thenReturn, verify, verifyNoInteractions.
  4. ArgumentCaptor, сопоставители eq, any, argThat и строгие стабы.
  5. spy, doReturn, mockStatic и агент для Java 21+.
  6. Срезовые тесты Spring с @MockitoBean или MockK для Kotlin.

Всё это проходится бесплатно с JDK, IntelliJ IDEA Community Edition и документацией. Если нужен маршрут с нуля, где тесты стоят после Spring, посмотрите онлайн-курс Брунояма «Java-разработчик»: семь месяцев, 24 модуля, три подряд модуля по Spring, сразу за ними модуль «Тестирование» и CI/CD. Спросите у школы, какие инструменты используют для тестов и разбирают ли моки сервисного слоя.

Открыть курс «Java-разработчик»

Упражнения и типичные ошибки

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

Ошибки повторяются из проекта в проект. Мокают чужие типы — цепочку вызовов HTTP-клиента вместо собственного адаптера. Проверяют через verify каждый вызов, включая запросы данных. Забывают закрыть mockStatic и отключают строгость на весь класс. Критерий простой: изменение устройства метода без изменения поведения не должно ронять ни один тест.

Когда нужен курс и что проверить в программе

Мокам почти не учат отдельно: их проходят в блоке о тестировании на курсе по Java или Android. Ищите в программе не слово Mockito, а практику: сдаётся ли проект с тестами и проверяет ли наставник сами тесты. Тем, кто идёт к бэкенду, подойдёт курс Skillbox «Java-разработчик + ИИ»: восемь месяцев, JUnit в стеке, юнит-тестирование на третьем уровне, затем Spring Boot и тесты бэкенда. Изучают ли на курсе Mockito, уточните у школы.

Открыть курс «Профессия Java-разработчик»

Тому, кто уже пишет на Java, курс может и не понадобиться: несколько недель практики на рабочем коде дадут больше. Он оправдан, когда нужен наставник, который объяснит, почему ваши тесты проверяют не то.

Недорогой вариант для самостоятельной работы — комплект Merion Academy «Java-разработчик с нуля» и «Автотестирование на Java»: два асинхронных курса примерно по 3–4 месяца, во втором — тестовые сценарии на JUnit и Selenium. Это скорее автотесты, чем моки, а наличие Mockito и подробную программу по модулям нужно уточнить у школы.

Открыть курс

Как навык влияет на доход

Отдельной надбавки «за Mockito» не бывает: это часть умения писать тесты, которого ждут от Java- и Kotlin-разработчика. В исследовании Хабр Карьеры за первое полугодие 2026 года (опубликовано 28 августа 2026-го) сказано: «Умение писать юнит-тесты и понимать TDD — ценится на рынке даже у джунов». Медиана по всем разработчикам там — 270 тысяч рублей в Москве, 247 тысяч в Санкт-Петербурге и 200 тысяч в регионах; разбивки по навыку тестирования нет.

Отдельным тегом тесты встречаются редко: на странице вакансий с навыком JUnit 15 октября 2026 года было две вакансии в Москве — middle Java и старший Android-разработчик, обе без зарплаты и без Mockito в навыках. Выборка мала для выводов. На деле навык проявляется в тестовом задании: проект с осмысленными тестами сервисного слоя выделяет кандидата.

Как выбрать обучение

Сравнивайте программы по трём вопросам: сдаётся ли проект с тестами, разбирают ли подмену зависимостей, есть ли ревью кода тестов. Школы собраны в рейтинге онлайн-школ с обучением Java — это общий рейтинг по языку, а не по тестированию. Если вы пишете на Kotlin под Android, уточните у школы, работают ли там с Mockito или MockK.