Mock часто описывает счастливую историю, а сервис — контракт. Клиент отправляет `page=0`, mock отвечает 200 с массивом, production требует `page>=1` и возвращает объект с `items`. Проблема не в качестве тестовых данных: две стороны проверяют разные соглашения.
Начните с одного падающего запроса и сравните его побайтно после удаления секретов. Совпадение JSON-полей недостаточно: method, Content-Type, код ответа, обязательные headers, nullability и формат ошибки тоже часть взаимодействия.
Drift matrix показывает, что именно устарело
| Измерение | Mock | Provider | Риск |
|---|---|---|---|
| Status | всегда 200 | 201/400/409 | Клиент не обрабатывает ветки |
| Field | name обязателен | 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/schema | OpenAPI document | Невалидное описание |
| Mock conformance | Examples/stubs vs schema | Устаревший mock |
| Consumer tests | Client vs mock | Неверное ожидание UI |
| Provider verification | Contracts vs provider | Несовместимый backend |
| Smoke staging | Маршрут и auth wiring | Ошибка окружения |
Пограничные примеры обновляются осознанно
- Зафиксировать версию контракта в клиентской сборке.
- Добавить пример минимального и максимального допустимого ответа.
- Отдельно хранить каждый status/error code.
- Проверить старого consumer с новым provider для заявленного окна совместимости.
- Сделать breaking change заметным в diff и release notes.
- Удалять старый mock только после миграции всех известных consumers.
Исправление готово, когда один контракт порождает или валидирует mock, реальные ответы provider проходят verification, а неизвестный запрос завершает тест ошибкой. Для разбора понадобятся версия OpenAPI/Pact, один mismatch report и обезличенная request/response пара.