Elasticsearch работает как отдельная поисковая проекция, поэтому сохранение товара в основной базе ещё не доказывает обновление поиска. Возьмите один `product_id` и одну версию изменения. Проверьте, было ли событие опубликовано, обработано consumer, записано в нужный физический индекс и стало видно поисковому запросу.
Не начинайте с принудительного `_refresh` всего кластера. Он помогает только если документ уже записан и ждёт видимости. Пропущенное событие, неверный alias, ошибку mapping или перезапись старой версией refresh не исправит.
Определите, какой именно слой устарел
| Проверка | Результат | Вывод |
|---|---|---|
| Основная БД | Версия товара старая | Проблема возникла до индексации |
| GET документа по ID | Новая версия есть | Запись выполнена; исследуйте search, refresh или запрос |
| GET по ID | Документа нет или версия старая | Проверьте consumer, индекс и конфликт версий |
| Поиск по точному ID | Возвращает другой документ | Запрос идёт через иной alias или фильтр |
Записывайте рядом с документом `source_version`, `indexed_at` и идентификатор события. Эти технические поля не показываются покупателю, зато отвечают на главный вопрос: какой снимок данных сейчас находится в поиске.
Проверьте alias до очереди и refresh
После reindex часто остаются два физических индекса: приложение пишет в один, а поисковый alias читает другой. Выведите разрешение alias и имя индекса из ответа записи. Если используются отдельные read и write aliases, проверьте оба. Нельзя делать вывод по красивому имени из конфигурации приложения — нужен фактический маршрут запроса.
product_id: 48217
source_version: 91
db_updated_at: 2026-09-29T22:12:04+03:00
event_id: product-48217-v91
consumer_result: indexed
physical_index: products-2026-09-29
read_alias: productsRefresh — это окно видимости, а не повторная индексация
Запись может успешно завершиться до того, как изменение станет видимым обычному search. Для пользовательского сценария «сохранить и сразу найти» точечно подходит `refresh=wait_for`: запрос дождётся очередного refresh. `refresh=true` заставляет немедленно обновить затронутые shards и при частом использовании ухудшает производительность.
Уточните `index.refresh_interval`. Значение `-1` отключает автоматические refresh, поэтому ожидание без другого события может затянуться. Для массовой загрузки это бывает осознанной оптимизацией; для обычного каталога — частая причина неожиданно старой выдачи после завершения импорта.
Защитите новую версию от старого события
Очередь может доставить события повторно или не по порядку. Если consumer просто перезаписывает документ, поздно пришедшая версия 90 затрёт уже записанную 91. Сравнивайте монотонную версию источника и отклоняйте устаревшее событие. Повтор того же event_id должен давать тот же итог без побочных действий.
- Логируйте product_id, source_version, event_id и физический индекс.
- Отделяйте retry временной ошибки от постоянной ошибки mapping.
- Отправляйте необработанные события в контролируемую DLQ, а не теряйте их.
- Для восстановления переиндексируйте выбранные ID и сохраняйте отчёт до массового запуска.
Тест, который воспроизводит рассинхронизацию
Измените один тестовый товар дважды подряд, получив версии N и N+1. Доставьте события consumer в обратном порядке. После ожидания штатного refresh GET и search должны показывать N+1, а лог — отклонение старого события. Затем переключите тестовый alias и убедитесь, что диагностика замечает расхождение индекса записи и чтения.
Для разбора производственной ошибки достаточно обезличенного product_id, временной линии двух версий, ответа bulk или update API, настройки refresh и разрешения aliases. Полную выгрузку каталога и пароли к кластеру передавать не нужно.