- evidence for replay, conflict, replay through a new API process and after restarting API and storages, keys table, key race, X-Instance-Id in responses and logs, explicit and invalid instance_id and key TTL, test runs - stand evidence: make wipe_data leaves the lab 2 volume intact, build from a fresh git clone passes smoke, bench restore stage sends with Idempotency-Key - REPORT.md: X-Instance-Id, idempotency design, IDEMPOTENCY_TTL_SECONDS mapping, limitations and evidence rows - tasks.md: mark the change tasks done, add follow-ups from verify Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
3.4 KiB
3.4 KiB
Повтор, конфликт и неверный ключ через HTTP
| Спеки | idempotency «Повтор того же тела», «Тот же JSON в другой записи», «Другой текст», «Нет ключа», «Неверный ключ», «Посторонний с чужим ключом», «Другой пользователь»; api-conventions «Instance id в успешном ответе и ошибке» |
| Change | instance-id-idempotency, задача 9.1 |
| Дата | 2026-10-08 16:44:53 UTC |
| Commit | af4bca0 |
| Стенд | make run_docker: проект mtusi-lab3, postgres, valkey, migrate, один контейнер api (образ mtusi-messenger:lab3 из af4bca0), 127.0.0.1:8080, без балансировщика |
| Хост | Docker Desktop 29.8.1, macOS arm64; ВМ Docker: 12 CPU, 7,7 GiB RAM; лимиты контейнерам не задавались |
| Клиент | разовый stdlib-скрипт; пароли и токены синтетические и в файл не попадают; ключ K — синтетический evidence-8ee385da82b54c1a8faf2ab3da763230 |
alice и bob — участники чата, eve — посторонний. Все запросы —
POST /api/v1/chats/{chat_id}/messages с Authorization: Bearer.
| Шаг | Запрос | Статус | X-Instance-Id |
Время | Проверка |
|---|---|---|---|---|---|
| отправка | alice, ключ K, Привет из evidence |
201 | 7956d7741a15 |
7,1 мс | |
| повтор | то же тело, тот же K | 201 | 7956d7741a15 |
4,8 мс | JSON совпал целиком: да |
| повтор | то же тело в записи {"text": "П…"} (пробел, \u-экранирование) |
201 | 7956d7741a15 |
4,2 мс | JSON совпал целиком: да |
| другое тело | тот же K, другое |
409 | 7956d7741a15 |
5,4 мс | conflict: Idempotency key was already used with another request |
| без ключа | валидное тело | 400 | 7956d7741a15 |
3,5 мс | header.Idempotency-Key: Field required |
| неверный ключ | Idempotency-Key: a b |
400 | 7956d7741a15 |
2,7 мс | header.Idempotency-Key: String should match pattern '^[A-Za-z0-9._:-]+$' — значение ключа в ответ не попало |
| посторонний | eve, тот же K и тело | 404 | 7956d7741a15 |
2,6 мс | not_found: доступ проверяется и при повторе |
| другой пользователь | bob, тот же K, от Боба |
201 | 7956d7741a15 |
4,2 мс | новое сообщение: область ключа — пользователь и чат |
Ответ первой отправки и обоих повторов:
{"id": "090a896a-dc91-4010-8332-3f6d3d97f858", "chat_id": "4b84e4e3-4a26-40d7-89a5-632d19bbbc31", "sender_id": "536d7a14-d489-45b9-b3e3-0f92822b3d62", "text": "Привет из evidence", "created_at": "2026-10-08T16:44:53.810923Z"}
История чата после всех шагов (bob читает): ["Привет из evidence", "от Боба"] — повторы, 409, 400 и 404 сообщений не создали.
Все ответы, включая ошибки, несут X-Instance-Id = 7956d7741a15 —
короткий ID контейнера api (docker compose ps -q api).