Импорт завершился.
Новые товары не появились.
Мы нашли ограничение в запуске cron: Magento сохраняла товары, но задания обновления индексов не выполнялись.
Восстановили фоновую обработку и подтвердили результат следующим импортом — без ручной переиндексации.
Клиент обнаружил пропавшие товары после очередного импорта
К нам обратился владелец интернет-магазина электротехнического оборудования на Magento Open Source 2.4.7. В каталоге были автоматические выключатели, контакторы, реле и комплектующие. Новые позиции, цены и характеристики регулярно загружались пакетным CSV-импортом. Для внутреннего поиска магазин использовал OpenSearch, а обновление индексов каталога выполнялось в режиме Update by Schedule.
Симптом на витрине
После очередного импорта менеджеры заметили расхождение: в административной панели новые артикулы уже существовали, но в соответствующих категориях на витрине их не было. Поиск по точному артикулу также не находил часть новинок. Старые товары при этом отображались, заказы принимались, а журнал импорта не показывал критических ошибок.
С чего начали
Сначала владелец предположил, что Magento не сохранила часть данных или что покупатели видят старую страницу из кеша. Массовую очистку кеша отложили до фиксации исходного состояния: сначала требовалось отделить устаревший ответ от устаревших индексов. Мы решили проследить весь путь товара — от записи импорта до категории и поискового результата.
Начали с конкретных артикулов, а не с общей переиндексации
Мы отобрали три контрольные группы: несколько новых самостоятельных товаров, которые отсутствовали и в категориях, и в поиске; несколько существующих товаров с изменёнными характеристиками; и старые позиции, которые продолжали отображаться корректно.
Сопоставили источник и результат импорта
Для каждой позиции сопоставили строку исходного CSV, SKU, время загрузки, данные административной панели и ожидаемую категорию. Проверили, что строки не были пропущены при валидации, артикулы сопоставились с ожидаемыми товарами, а назначения website и категорий сохранились. Отдельно установили фактическое поведение используемого процесса импорта: какие изменения он сохраняет и какие индексаторы после этого ожидают фоновой обработки.
Проверили сохранённые записи
Отсутствующие на витрине позиции существовали в исходных данных Magento: у них были внутренние идентификаторы, названия, цены и предусмотренные категории. Для контрольной выборки это исключило потерю исходных товарных записей при импорте. Но наличие строки в базе само по себе ещё не означает, что товар должен показываться покупателю.
Исключили причины, не связанные с индексаторами
Публикация товара
На нужном website и его store view проверили Enabled, Visibility, принадлежность website и привязку к нужной категории. У исследованных самостоятельных товаров стояла видимость Catalog, Search. Категории были активны и относились к правильному дереву магазина.
Самостоятельный товар или вариант
Отдельно исключили типичную ложную тревогу с дочерними simple-товарами configurable product. Для таких вариантов Not Visible Individually может быть нормальной настройкой: они не обязаны появляться отдельными карточками. Наши контрольные SKU были самостоятельными товарами, которые должны отображаться на витрине.
Мы также проверили прямое обращение к карточкам и состояние URL отдельно от выдачи категорий. Для части контрольных SKU подробные страницы открывались по прямому адресу, хотя в категории и поиске товары не находились. Это помогло отделить доступность товарной записи от её участия в индексированной выборке, но само по себе не доказывало исправность индексов.
Разделили исходные данные, индексы и кеш
В Magento результат импорта не равен готовой витрине. Исходные данные товара сохраняются в базе, а индексаторы формируют структуры для работы категорий, цен, поиска и других функций. Дополнительно Magento и фронтенд могут отдавать кешированные результаты.
Мы сформулировали три разные версии:
Первую версию предыдущие проверки не подтвердили. Чтобы различить вторую и третью, мы изучили состояние индексаторов до массовой очистки кеша.

Установили режим индексаторов и характер отставания
Через команды bin/magento indexer:info, indexer:show-mode и indexer:status мы проверили состав индексаторов, режимы работы и их состояние. Особое внимание уделили catalog_category_product, catalog_product_category и catalogsearch_fulltext; дополнительно проконтролировали индексацию цен и складской доступности. Названия доступных индексаторов сверяли с фактическим составом установленной системы.
Режим обновления
Основные каталожные индексаторы работали в режиме Update by Schedule. Это штатный вариант для магазина с регулярными массовыми обновлениями: изменения не обязательно отражаются на витрине немедленно после сохранения каждого товара, их обрабатывают фоновые задания.
Что не показывал один статус Ready
Здесь обнаружилась важная деталь. Одного статуса Ready было недостаточно, чтобы гарантировать отсутствие очереди изменений. Индексатор может не требовать полной переиндексации, но при этом отставать по обработке накопленных изменений MView. Поэтому мы проверили не только status, но и служебные данные отслеживания изменений.
Проверили MView и журналы изменений
Magento использует механизм MView: для подписанных таблиц изменения фиксируются в changelog-таблицах, а в mview_state хранится информация о последней обработанной версии представления. Это позволяет индексатору в режиме Update by Schedule обрабатывать поступившие изменения пакетами.
Что сопоставили в MView
Для каждого затронутого представления сопоставили последнюю применённую версию из mview_state с фактически существующими записями соответствующего changelog, у которых version_id был больше. В повторных наблюдениях такие записи сохранялись. Разность номеров версий не выдавали за количество событий или товаров: в нумерации возможны пропуски, а один товар может участвовать в нескольких изменениях. Обработанные строки журнала также могут некоторое время храниться до штатной очистки.
На тестовой копии мы также выполнили небольшое контролируемое изменение товара и проверили, фиксируется ли оно в соответствующем механизме отслеживания. Изменение учитывалось. Значит, искать причину в ручном восстановлении триггеров базы не было оснований: записи о необходимости обновления появлялись, но не доходили до исполнения.
Сопоставили выполнение группы default и группы index
Magento разделяет фоновые задачи по группам. Обычные операции относятся преимущественно к default, а обновление индексаторов — к index. Нас интересовали задания indexer_update_all_views и indexer_reindex_all_invalid, а также история cron за время появления проблемы.
Мы сопоставили job_code в cron_schedule с конфигурацией cron-групп и журналами Magento. В самой cron_schedule отдельной колонки группы нет. В доступном интервале наблюдения задания default создавались и выполнялись, но для индексирующих задач не появлялись новые успешные циклы. Краткую историю cron_schedule не принимали за доказательство событий многодневной давности: успешные записи очищаются по правилам хранения. Для хронологии использовали сохранившиеся серверные журналы и изменение расписания.
После этого проверили crontab владельца файлов Magento и остальные используемые точки запуска — системные задания, настройки хостинга и другие узлы приложения. Это позволило исключить отдельный запуск index, который не был бы виден в одном пользовательском crontab. В конфигурации обнаружилась строка, оставшаяся после недавнего обслуживания сервера:
bin/magento cron:run --group=default
Приведённый фрагмент команды ограничивал выполнение группой default. В этой конфигурации не оказалось отдельного запуска index. Штатный запуск cron:run без ограничения группы должен был обеспечивать обработку всех настроенных групп; именно этот вариант использовался в проекте до изменения расписания.
Так объяснилось, почему сайт не выглядел полностью сломанным: задания default продолжали выполняться, но индексация по расписанию фактически прекратилась.

Связали изменение расписания с появлением неисправности
Мы сопоставили время обслуживания сервера, изменение системной cron-команды, период появления новых SKU и отставание MView. Последовательность совпала: после ограничения запуска группой default новые изменения поступали в Magento, но соответствующие индексы не обновлялись по расписанию.
Это объясняло и неоднородную картину на витрине. Старые товары оставались в ранее сформированных индексах, тогда как новые позиции могли отсутствовать. Обновлённые характеристики или поисковые данные существующих товаров также могли оставаться устаревшими.
Подтвердили причину на изолированной копии
Дальнейшие проверки выполняли на ранее подготовленной изолированной копии. Поведение импорта воспроизводили с теми же настройками публикации и индексаторов; внешние платежи, письма и интеграции оставались отключёнными.
Отделили кеш от индексов
Сначала воспроизвели расхождение: после импорта новые записи существовали, но при запуске только default не появлялись в ожидаемой выдаче. Проверку кеша провели отдельно — получение свежего ответа без старой кешированной страницы не возвращало контрольные SKU. Поэтому одного обновления кеша для устранения этого расхождения было недостаточно.
Проверили влияние переиндексации
Затем выполнили штатную переиндексацию затронутых направлений и сравнили свежие ответы в тех же условиях. Новинки появились в категориях и внутреннем поиске. Статус, видимость, website, категорию и настройки поиска по SKU не меняли. Дополнительно сопоставили участие контрольных товаров в обновлённых индексированных данных: исчезновение симптома не оценивали только по виду страницы.
Воспроизвели повторение и исправление
После следующего импорта при сохранённом запуске только default отставание повторилось. Затем исправили запуск cron на копии и проследили ещё одно обновление: нужные задания выполнились по расписанию, а товары появились без ручного reindex. Так разделили четыре события: очистку кеша, восстановление индексов, повторение неисправности и устранение её причины.

Восстановили правильный запуск cron
Перед переносом исправления на рабочий магазин сохранили конфигурацию расписания и проверили актуальность резервной копии. Сверили владельца файлов, полный путь к приложению, используемый PHP CLI, его расширения и права доступа; оценили свободное место и возможность обработать накопившиеся изменения. Также убедились, что нет второго запуска под другим пользователем или на другом серверном узле, который мог бы одновременно обрабатывать те же задания.
Исправление на рабочем магазине
Мы восстановили штатный запуск Magento cron без ошибочного ограничения --group=default. Не стали добавлять ещё одну параллельную задачу поверх уже существующей: это могло вызвать дублирование запусков. Проверили корректный путь к приложению и совместимость PHP CLI с используемой версией Magento.
Изменять режим индексаторов на Update on Save не потребовалось. При регулярных массовых импортах это не устранило бы первопричину и могло бы увеличить стоимость записи данных.
Проследили последовательные циклы
После восстановления расписания наблюдали несколько последовательных циклов cron, сопоставляя время журналов в одной временной зоне. Первый запуск может сформировать задания на будущее; следующий должен обработать задачи, для которых наступило scheduled_at. Поэтому одну успешную команду не считали доказательством полностью исправленной системы.
Проверили завершение задач
В cron_schedule появились задания индексирования, затем успешные завершения. В журналах не возникло ошибок доступа к файловой системе или подключения к базе. Но к этому моменту накопилась очередь старых изменений, и её состояние требовало отдельной проверки.
Обработали накопившиеся изменения без пересоздания товаров
Сначала оценили объём отставания MView и проверили, какие индексаторы могли обновиться инкрементально, а какие требовали полного перестроения. Зафиксировали время и состояние до начала работ, чтобы отличать новое поступление изменений от старой очереди.
Затем под контролем нагрузки дали восстановленному расписанию обработать накопившиеся изменения. Различали частичное обновление через indexer_update_all_views и полную перестройку неактуальных индексов через indexer_reindex_all_invalid. Дополнительный ручной reindex поверх работающего задания не запускали. Результат оценивали по обработанным изменениям и контрольным товарам, а не только по завершению команды cron.
После завершения сопоставили обработанные версии MView с доступными новыми записями и убедились, что отставание устраняется. При этом учли, что во время работы магазина в журнал могут поступать новые изменения; важна нормальная последовательная обработка, а не искусственно постоянный ноль во всех таблицах.
Проверили OpenSearch отдельно от SQL-индексаторов
Поскольку внутренний поиск работал через OpenSearch, мы не ограничились состоянием индексаторов MySQL. Проверили доступность сервиса из Magento, подключение, состояние поискового индекса и отсутствие ошибок при обновлении каталожного поиска.
Обновление поисковых данных
Чтение ранее сформированного поискового индекса работало и до исправления. Успешное обновление новых документов проверяли отдельно, после восстановления фоновой обработки. После восстановления обработки catalogsearch_fulltext проверили новые позиции по точным SKU, названию и характерным техническим словам.
Результат для покупателя
Проверку проводили через обычный поиск магазина, а не только по служебному статусу задания. Это важно: успешный reindex сам по себе не гарантирует правильную выдачу покупателю при ошибке конфигурации поискового сервиса.
Проверили витрину и кеш на реальных пользовательских маршрутах
Категории и фильтры
Теперь вернулись к жалобам владельца. Открыли категории, в которые добавлялись новые контакторы и реле, и сверили список товаров с контрольными SKU. Проверили первую и последующие страницы, сортировку и фильтрацию.
Карточки и ссылки
Затем открыли карточки товаров и проверили HTTP-ответы, цены, наличие и ссылки из категорий. Видимость в категории, работа прямого URL и попадание во внутренний поиск контролировались отдельно: это разные маршруты получения данных.
После обновления индексов отдельно проверили инвалидирование связанного кеша и повторные ответы витрины. Проверка охватывала используемые в проекте слои кеширования, а не только команду Magento. Массовая очистка всего кеша не стала частью штатного процесса каждого импорта.
Связанный разбор: почему после очистки кеша магазин начинает тормозить.
Проверили цены, остатки и последствия отставания
Проблемный импорт затрагивал не только появление новых SKU, но и изменения цен и некоторых характеристик существующих товаров. Поэтому проверить одни категории было недостаточно.
Товарные данные и корзина
Мы сопоставили значения в исходном файле, карточках Magento, витрине и корзине для контрольной выборки. Также проверили складскую доступность по принятой схеме Inventory Management: количество по источникам, соответствующий stock и Salable Quantity не смешивали между собой.
Проверка создания заказа
После восстановления индексов повторно сверили доступность контрольных SKU и цены в корзине. На изолированной копии проверили создание заказа с новым товаром без реального списания денег; рабочие платёжные интеграции для такого теста не использовали. Повторно загружать весь исходный импорт или массово менять остатки не потребовалось.
Доказали исправление следующим штатным импортом
Самая важная контрольная проверка состояла не в том, что товары появились после ручной переиндексации. Нужно было установить, что система снова самостоятельно обрабатывает новые изменения.
Новые данные на копии
Для этого на тестовой копии выполнили небольшой новый импорт: добавили одну самостоятельную позицию и изменили характеристику существующего товара. Сначала проверили сохранение исходных данных. Затем убедились, что необходимые события попали в механизм отслеживания изменений и что cron группы index выполнил соответствующие задания.
Появление и повторное обновление SKU
После их завершения новый товар появился в нужной категории и поиске, а изменённая характеристика стала отображаться на витрине. Мы проверили повторное обновление того же SKU — не только первое появление товара.
Очередной импорт рабочего магазина
Затем аналогично проследили очередное штатное обновление рабочего магазина: импорт, появление новых записей, цикл cron, изменение состояния индексов и фактическую выдачу каталога. Наблюдаемая задержка соответствовала расписанию фоновой обработки, накопление необработанной очереди больше не повторялось в проверенном цикле.

Сверили адреса и контроль дальнейших обновлений
Отсутствие товаров в категориях может означать отсутствие ожидаемых внутренних ссылок на новые карточки. Поэтому после восстановления витрины проверили доступность товарных страниц через каталог, правильность внутренних URL и HTTP-ответов.
Отдельно проконтролировали canonical, работу категорий и пагинации. Повторно создавать товары или менять их URL не пришлось: исходные записи и связи оставались в Magento.
Контроль дальнейших обновлений
Для дальнейшего контроля связали признаки разных уровней: завершение импорта, последний успешный цикл задач index, продвижение MView и появление контрольного товара на витрине. Успешное выполнение default больше не использовали как единственный признак исправности фоновых задач.
Что получилось в результате
На момент обращения
На момент обращения магазин успешно сохранял импортированные товары, но часть новинок не появлялась в категориях и внутреннем поиске. Основные настройки этих товаров были корректными, а OpenSearch продолжал обслуживать старый ассортимент.
Установленная причина
Мы установили, что после обслуживания сервера системный запуск Magento ограничили группой cron default. Группа index перестала выполняться; изменения накапливались в механизме MView и не доходили до актуальных индексов.
Причину подтвердили сопоставлением журналов импорта, состояния индексаторов, версий MView, истории cron и фактического поведения витрины. Изолированная переиндексация возвращала товары, но без восстановления расписания следующие изменения снова задерживались.
Не потребовалось удалять или повторно создавать весь ассортимент, откатывать базу, менять товарные URL или переносить магазин на новый сервер. Проблема была устранена в том месте, где прерывалась цепочка обработки данных.
Неисправность маскировалась тем, что старый каталог продолжал работать. Итогом восстановления стала проверенная обработка новых изменений по расписанию, а не только разовое возвращение товаров после ручной переиндексации. Вывод относится к выполненным контрольным циклам и не заменяет дальнейшего наблюдения.
Что важно в этом восстановлении
Почему товар был в административной панели, но отсутствовал на витрине?
Импорт сохранял исходные данные. Но обновление соответствующих индексов ожидало фоновых задач группы index, которая не запускалась. Поэтому новые записи и фактическая выдача расходились.
Почему одной очистки кеша было недостаточно?
На изолированной копии свежий ответ без старой кешированной страницы также не содержал контрольных товаров. Их отсутствие было связано с состоянием индексов; после исправления отдельно проверили и обновление кеша.
Разве статус Ready не подтверждает исправность каталога?
В этом расследовании мы сопоставляли состояние индексатора с продвижением MView, завершением задач cron и появлением контрольных SKU. Один статус не заменял проверку обработки накопленных изменений.
Почему не ограничились ручной переиндексацией?
Она возвращала товары, но при прежнем ограничении cron следующий импорт снова оставлял изменения необработанными. Исправление подтвердили обновлением каталога после штатных фоновых задач.
Пришлось ли пересоздавать товары или менять их адреса?
Нет. Исходные записи и связи сохранялись в Magento. Мы восстановили обработку изменений, сохранили товарные URL и проверили ссылки из каталога.
Восстановление OpenSearch означает возвращение страниц в Google?
Нет. OpenSearch обслуживает внутренний поиск магазина. После исправления мы проверили доступность товаров и ссылки на них; изменения индексации и позиций Google в результат кейса не включали.
