Практика системного анализа · 6 минут
Идемпотентность после таймаута: какие доказательства нужны до повторного запроса
Как проверить повтор POST после потери ответа: сохранить ключ, сверить неизвестный исход, обнаружить двойной эффект и задать контракт параллельных попыток.
Идемпотентность операции означает, что повтор одинакового запроса не создаёт дополнительного целевого эффекта. Таймаут сообщает о проблеме ожидания ответа; по нему нельзя определить, успел ли сервер сохранить результат. Поэтому проверка повторов начинается с восстановления состояния первой попытки.
Запрос ушёл, ответ потерян
В учебном сервисе клиент создаёт заявку POST /requests. Сервер сохраняет её, но ответ не доходит до клиента. У клиента состояние unknown: исход неизвестен. Это синтетический сценарий для тестового протокола, без сетевого эксперимента и реальных записей.
Если клиент создаст новый ключ и отправит ту же заявку, сервер может распознать её как новую операцию. Корректный формат ответа и успешный статус второго запроса не покажут, что теперь существуют две заявки.
HTTP Semantics, RFC 9110 §9.2.2 определяет идемпотентность через эффект нескольких одинаковых запросов. Для POST нельзя предполагать её только по методу. Нужен прикладной контракт повторов.
Договориться о ключе и области действия
Для учебного сервиса зададим решения K1–K5. Это проектные условия примера, не универсальная спецификация заголовка Idempotency-Key.
- K1: ключ уникален внутри организации и операции создания заявки.
- K2: сервер связывает ключ с нормализованными значимыми полями тела.
- K3: одинаковый ключ и одинаковое тело возвращают результат исходной операции без новой заявки.
- K4: тот же ключ с другим телом вызывает конфликт без изменения сохранённой заявки.
- K5: сервер хранит запись ключа 24 часа; после истечения срока клиент сначала выполняет сверку результата.
Проверку полномочий сервер выполняет при каждом запросе, включая повтор. Ключ не должен давать доступ к чужому результату. Нужен также ответ для параллельного запроса, пока сервер ещё выполняет первую операцию: ожидание или документированное состояние «в работе», без второго эффекта.
В Stripe API ключи используют для безопасных повторов при ошибках соединения. Это пример конкретного API; его условия хранения и обработки нельзя переносить на другой сервис без проверки.
Журнал попыток и сверка
| Попытка | Ключ | Значимые поля | Наблюдение клиента | Серверный результат в стенде |
|---|---|---|---|---|
| A1 | req-demo-1 | amount=120, currency=EUR | Таймаут, unknown | Создана R501 |
| A2 | req-demo-1 | amount=120, currency=EUR | Ответ R501 | Новых заявок нет |
| A3 | req-demo-1 | amount=121, currency=EUR | Конфликт | R501 не изменена |
| A4 | req-demo-2 | amount=120, currency=EUR | Ответ R502 | Новая заявка |
A4 показывает границу защиты: новый ключ означает новую операцию по выбранному контракту. Защита от случайного дублирования бизнес-заявки по другим признакам потребовала бы отдельного правила.
Сверка переводит A1 из unknown в reconciled, когда клиент получил подтверждение R501 через предусмотренный контрактом повтор или поиск по идентификатору операции. Отсутствие записи в кратковременном кеше клиента такого подтверждения не даёт.
Протокол теста двойного эффекта
На отдельном тестовом стенде подготовьте пустой набор заявок и фиксированную организацию. Для A1 установите управляемую потерю ответа после сохранения. Затем повторите A2 с тем же ключом и телом.
Проверяйте одновременно идентификатор результата и число бизнес-эффектов. В примере после A2 должна существовать ровно одна заявка R501; после A3 её сумма остаётся 120. Если операция также ставит задание в очередь, нужно проверить количество таких заданий. Один объект в базе не исключает двух уведомлений или двух выплат.
Параллельный тест запускает две одинаковые попытки с одним ключом. Обе должны ссылаться на один результат либо одна ждать завершения другой. После завершения число целевых эффектов остаётся единицей. Эти ожидания нельзя проверить сравнением только HTTP-ответов.
Предусмотрите отдельный тест истечения 24 часов и восстановления после сбоя между созданием заявки и записью ключа. Реализация должна сохранять согласованность этих действий; иначе повтор найдёт незанятый ключ при уже созданном объекте.
Что может проверить LLM
Модель может найти незаданные состояния и составить таблицу повторов. Ей нужны K1–K5 и точка потери ответа. Без них она легко предложит «повторять три раза» и оставит причину дубля нетронутой.
Готовый артефакт — протокол с ожидаемым числом эффектов и способом сверки неизвестного исхода. Его можно включить в постановку задачи, а наблюдаемый результат оценить по разбору доказательств зелёного теста.
Вопросы по повторам
Таймаут означает, что запись не создана?
Нет. Сервер мог сохранить запись до потери ответа. Клиент должен восстановить исход предусмотренным способом и сохранить связь с первой попыткой.
Можно ли после таймаута сгенерировать новый ключ?
Новый ключ может создать новую операцию. Такое действие требует подтверждённого основания, а не одного сообщения о таймауте.
Достаточно вернуть одинаковый идентификатор?
Нет. Нужно проверить число целевых эффектов: объектов, заданий и других действий, которые входят в обещание операции.
Что делать с тем же ключом и другим телом?
Следовать контракту API. В учебном примере сервер возвращает конфликт и сохраняет исходную заявку без изменения.
Проверялся ли здесь работающий сервис?
Нет. Таблица задаёт синтетические ожидания. Исполнение требует отдельного стенда, управляемого сбоя и доступа к доказательствам эффекта.
Автор: Иннокентий Бодров, автор Аналитической мастерской.