Mock часто описывает счастливую историю, а сервис — контракт. Клиент отправляет `page=0`, mock отвечает 200 с массивом, production требует `page>=1` и возвращает объект с `items`. Проблема не в качестве тестовых данных: две стороны проверяют разные соглашения.

Начните с одного падающего запроса и сравните его побайтно после удаления секретов. Совпадение JSON-полей недостаточно: method, Content-Type, код ответа, обязательные headers, nullability и формат ошибки тоже часть взаимодействия.

Drift matrix показывает, что именно устарело

ИзмерениеMockProviderРиск
Statusвсегда 200201/400/409Клиент не обрабатывает ветки
Fieldname обязателенdisplayNameПустой интерфейс
Nullabilityстрокаnull возможенRuntime error
Paginationмассивitems + cursorПотеря страниц
Headersне проверяютсяIdempotency/ETagНеверный повтор
Error bodyпроизвольный textструктурированный codeНет понятного сообщения

OpenAPI фиксирует минимум ответа

openapi: 3.1.0
paths:
  /orders/{id}:
    get:
      responses:
        '200':
          description: Order found
          content:
            application/json:
              schema:
                type: object
                required: [id, status]
                properties:
                  id: { type: string }
                  status:
                    type: string
                    enum: [new, paid, cancelled]
        '404':
          description: Order not found

Спецификация должна описывать все используемые статусы и content types, а не только форму 200. Генератор mock читает зафиксированную версию контракта. Изменение schema проходит review и compatibility check вместе с клиентами.

Строгий stub отвергает неизвестный запрос

WireMock умеет сопоставлять method, URL path, query, headers и body. Чем шире matcher, тем легче тесту случайно попасть не в тот сценарий. Установите явные приоритеты и catch-all 404; после теста запросите журнал unmatched requests и требуйте, чтобы он был пуст.

  • Не используйте один regex `.*` для всех endpoint.
  • Сравнивайте Content-Type и важные request headers.
  • Проверяйте body schema и бизнес-значимые поля.
  • Добавьте timeout, 429, 5xx и malformed response как отдельные сценарии.
  • Не записывайте production traffic без очистки токенов и персональных данных.
  • Не обновляйте golden response автоматически после любого изменения provider.

Provider verification замыкает контракт

Consumer-driven contract хранит взаимодействия, которые нужны клиенту. Pact verifier выполняет их против запущенного provider и сообщает mismatches. Provider states должны подготовить известные данные: «заказ существует», «заказ отсутствует», «пользователь без доступа». Внешние зависимости provider при этом контролируются отдельно.

Проверка CIЧто запускаетЧто блокирует
Lint/schemaOpenAPI documentНевалидное описание
Mock conformanceExamples/stubs vs schemaУстаревший mock
Consumer testsClient vs mockНеверное ожидание UI
Provider verificationContracts vs providerНесовместимый backend
Smoke stagingМаршрут и auth wiringОшибка окружения

Пограничные примеры обновляются осознанно

  1. Зафиксировать версию контракта в клиентской сборке.
  2. Добавить пример минимального и максимального допустимого ответа.
  3. Отдельно хранить каждый status/error code.
  4. Проверить старого consumer с новым provider для заявленного окна совместимости.
  5. Сделать breaking change заметным в diff и release notes.
  6. Удалять старый mock только после миграции всех известных consumers.

Исправление готово, когда один контракт порождает или валидирует mock, реальные ответы provider проходят verification, а неизвестный запрос завершает тест ошибкой. Для разбора понадобятся версия OpenAPI/Pact, один mismatch report и обезличенная request/response пара.

Проверенные источники