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: products

Refresh — это окно видимости, а не повторная индексация

Запись может успешно завершиться до того, как изменение станет видимым обычному 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. Полную выгрузку каталога и пароли к кластеру передавать не нужно.

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