Клиент обратился после переноса магазина
К нам обратился владелец интернет-магазина сантехники и оборудования для дома. Магазин перенесли с OpenCart 3 на OpenCart 4, одновременно обновили тему оформления и несколько расширений. Каталог открывался, товары отображались, корзина работала. Но покупатели начали сообщать, что по сохранённым ссылкам и переходам из поиска больше не могут попасть на некоторые карточки.
Вместо товара появлялась ошибка 404. В других случаях открывалась главная страница, хотя адрес в браузере оставался похожим на товарный. При этом нужную позицию удавалось найти через каталог нового магазина.
В Search Console также появились сведения о недоступных URL, а по части затронутых страниц снизились переходы. Владелец предполагал, что достаточно обновить карту сайта и дождаться повторной обработки страниц поисковой системой.
Сначала отделили потерю адресов от потери товарных данных
Мы собрали ссылки из обращений покупателей и отчётов Search Console, затем проверили каждый адрес. Фиксировали исходный HTTP-ответ, возможные перенаправления, конечный URL и фактическое содержимое страницы.
У части ссылок подтвердился ответ 404. Другие возвращали HTTP 200 с содержимым главной страницы. Такие ответы не считали успешным открытием товара: отдельно сверяли название, артикул, изображение и язык карточки.
После этого нашли соответствующие товары в административной панели. Проверили их активность, привязку к магазину, описания на нужном языке и доступность через внутренний маршрут с параметром product_id. Исследованные карточки открывались с правильными данными.
Это сузило задачу. Для проверенных товаров проблема заключалась в обработке человекопонятных адресов, а не в исчезновении самих карточек. Распространять этот вывод на весь ассортимент до сверки остальных URL мы не стали.
Проверили, где именно переставал распознаваться запрос
Первой версией была ошибка серверных правил переписывания URL. Мы проверили настройки SEO URL, конфигурацию веб-сервера и обработку работающих и проблемных путей.
Само наличие нескольких исправных ссылок ещё не исключало ошибку серверной конфигурации: отдельные правила могли затрагивать только определённую группу адресов. Поэтому сравнивали прохождение конкретных запросов, а не ограничились открытием главной и одной карточки.
Для исследованных URL запросы доходили до OpenCart. В журналах PHP не нашли аварийного завершения, которое объясняло бы проверенные случаи. При этом сам факт передачи запроса приложению ещё не подтверждал правильность всех преобразований пути на сервере.
Мы не объявляли серверную конфигурацию полностью проверенной на основании работающих ссылок. Следующим этапом стала сверка конкретных SEO-соответствий и правил формирования адресов. Обнаруженные расхождения проверяли на копии, сохраняя общие серверные правила: это позволяло оценить результат исправлений в данных и маршрутизации магазина без одновременной перенастройки всего веб-сервера.
Нашли неполный перенос SEO-соответствий и изменение структуры путей
В прежнем магазине работало SEO-расширение, которое участвовало в формировании товарных адресов с категориями. Оно определяло не только отдельные ключевые слова, но и то, как из них собирался и распознавался полный путь.
После перехода на OpenCart 4 прежние правила расширения больше не участвовали в обработке запросов. Новая конфигурация формировала часть ссылок иначе. Одновременно обнаружились пропуски в перенесённых SEO-соответствиях.
Мы сравнили записи старой и новой базы, включая формат связи SEO-ключа с товаром. Проверка касалась не только наличия знакомого слова в адресе: оно должно было соответствовать нужному product_id в формате действующей системы, с правильными привязками к магазину и языку.
Однако различие полей само по себе ещё не объясняло неисправность. Мы проверили, какие параметры фактически восстанавливает обработчик из проблемного URL: определяется ли нужный товар и получается ли маршрут его карточки. Наличие записи с product_id не считали достаточным, если запрос всё равно открывал другую страницу.
Поэтому и исправления разделили. Для первой группы восстанавливали недостающую связь адреса с товаром и проверяли прямое открытие карточки. Для второй сохраняли рабочую карточку и настраивали переход со старого полного пути на её основной URL.
Показ главной страницы с кодом 200 не использовали как доказательство конкретного дефекта в обработчике. Если такой адрес был однозначно связан с действующим товаром, его включали в ту же карту восстановления. Отдельную причину поведения всех неизвестных путей из этого наблюдения не выводили.
Сверили товары и составили карту адресов
До внесения изменений мы проверили, что старые ссылки будут связаны именно с нужными товарами. Совпадение названия или числового product_id само по себе не считали достаточным.
Сопоставили идентификаторы, артикулы, сведения о товарах и их связи с категориями. Проверили активность карточек, привязку к магазину и наличие соответствующих языковых описаний. В исследованных группах идентификаторы сохранились, а товарные данные подтвердили соответствие.
Привязки store_id и language_id сверили с настройками новой установки. Старые числовые значения не переносили автоматически: они должны были соответствовать действующему магазину и нужному языку.
Для сбора прежних URL использовали сохранённую карту сайта, старую базу, данные поисковых переходов, доступные серверные журналы и внутренние ссылки. Это расширило список по сравнению с одними обращениями покупателей, но не давало оснований объявлять его перечнем всех когда-либо существовавших адресов.
Для каждого найденного пути определили прежний товар, его состояние после миграции, язык страницы и выбранный основной URL. Отдельно отметили альтернативные пути через разные категории и адреса без однозначного соответствия. Последние не включали в автоматическое восстановление.
Так появилась рабочая карта: исходный URL, связанный с ним товар, текущее состояние карточки и ожидаемый результат после исправления. По этой же карте мы затем проверяли внедрение.

Определили, какие адреса сохраняем, а какие перенаправляем
Мы не стали менять адреса всего каталога ещё раз. Там, где выбранный основной URL можно было восстановить в действующей конфигурации, исправляли его обработку. Если товар уже получил другой основной адрес, подтверждённый сверкой, связывали прежний путь с ним постоянным перенаправлением.
Для товара, находившегося в нескольких категориях, определили один основной адрес в каждой языковой версии. Альтернативные старые пути учитывали отдельно, чтобы они не вели к разным карточкам или конфликтующим каноническим адресам.
Также разделили недоступность товара для покупки и отсутствие самой страницы. Нулевой остаток или прекращение продаж не были автоматическим основанием для удаления карточки. Такие товары проверяли по состоянию каталога и решению владельца о сохранении страницы.
Перенаправление на замену рассматривали только при подтверждённом соответствии. Похожее название или принадлежность к той же категории для этого не подходили. Для действительно удалённых страниц без подходящей замены сохраняли корректный ответ 404 и понятное сообщение посетителю.
Подготовили исправления и проверили их на копии
Работы с маршрутизацией сначала выполнили на отдельной копии с той же версией OpenCart и теми же компонентами, которые участвовали в формировании адресов. Сохранили исходные настройки и записи, необходимые для возврата внесённых изменений.
Для первой группы восстановили недостающие соответствия SEO-ключей идентификаторам товаров в формате новой системы. Затем проверили, что при разборе выбранного URL определяется не только product_id, но и маршрут карточки. Записи, необходимые для остальных частей пути, сверили с установленным обработчиком. Существующие исправные соответствия не дублировали.
Конфликты проверяли по фактическому поведению установленного обработчика. Разные language_id не считали достаточной защитой от неоднозначности одинаковых ключей: важно было, какую запись выбирает система при открытии полного адреса.
Затем проверили обе стороны работы маршрутизации. С одной стороны, введённый URL должен был открывать нужную карточку. С другой — ссылки, которые OpenCart создавал для этой карточки, должны были вести на выбранный основной адрес.
После восстановления соответствий повторили запросы к выбранным основным адресам. Карточки этой группы открывались напрямую с HTTP 200, правильным товаром и нужным языком. Результат сравнили с открытием того же товара через внутренний маршрут.

Связали прежние пути с действующими карточками
Для изменившихся путей настроили серверные перенаправления 301 по подготовленной карте. Каждый старый адрес связывался с конкретным конечным URL соответствующего товара и языка.
Сначала проверили сами конечные страницы: правильный товар, HTTP 200 и согласованный основной адрес. Только после этого использовали их как цели перенаправлений.
Сопоставление не ограничивали последним словом в пути. Одинаковые окончания могли встречаться у разных адресов, поэтому учитывали полный старый путь и языковую принадлежность. Порядок применения правил проверили вместе с действующей маршрутизацией.
Правила для старых карточек не распространяли на оформление заказа, личный кабинет, платёжные обработчики и другие служебные запросы. Адреса с параметрами фильтрации, сортировки и выбора страницы проверяли отдельно: удалять параметры без учёта их назначения было нельзя.
Для перенаправляемых URL проверили всю цепочку до конечной карточки. Убрали лишние промежуточные переходы, исключили циклы, перенаправления на самих себя и возврат с нового адреса на старый.
Для старых товарных адресов, которые прежде показывали главную с кодом 200, проверили исходный ответ отдельно от конечного. В тех случаях, где карта предусматривала переход на действующий товар, старый URL теперь возвращал 301, а конечная карточка — 200 с нужным содержимым. Так подтвердили исправление именно этих ссылок.

Удалённые карточки без подходящей замены в товарные перенаправления не включали. Для проверенных адресов этой группы контролировали ответ 404 и страницу отсутствующего товара. Вывод относился к проверенному списку: изменение известных товарных ссылок не считали доказательством правильной обработки любого произвольного пути на сайте.
Согласовали языковые версии и canonical
Магазин работал на украинском и русском языках. Для обеих версий мы проверили не только записи SEO URL, но и результат прямого открытия карточки. Адрес должен был определять нужный товар и соответствующее языковое содержимое.
Проверку не ограничили сеансом, в котором язык уже был выбран. Отдельно оценили прямые входы и переключение языка: переход должен был сохранять товар, а не возвращать посетителя на главную или другую карточку.
Для каждой языковой версии сверили canonical. Он указывал на выбранный основной адрес этой версии, который открывался напрямую и был доступен для индексации. Украинскую и русскую карточки не объединяли канонической ссылкой на один язык.
В формируемых системой hreflang исправили ссылки на устаревшие адреса и промежуточные перенаправления. Проверили соответствие языков и взаимные связи между актуальными страницами одного товара.
Обновили внутренние ссылки и карту сайта
После исправления маршрутизации проверили ссылки из меню, категорий, хлебных крошек, блоков связанных товаров и содержимого страниц. Часть из них продолжала вести на прежние варианты адресов.
Сохранённые вручную ссылки заменили на конечные URL. Для автоматически создаваемых ссылок исправили формирование адресов в действующей конфигурации. В результате проверенные навигационные элементы стали вести непосредственно на нужные страницы.
Затем обновили XML Sitemap. В неё вошли актуальные основные адреса страниц, предназначенных для индексации. Проверили, что карта не подставляет вместо них перенаправления, ошибки 404 и случайные технические варианты.
Сверили ответы страниц, метатеги robots, заголовки X-Robots-Tag и правила robots.txt. Проверка касалась как конечных карточек, так и доступности старых путей, по которым поисковая система должна получить перенаправление.
Настройки тестового окружения не переносили на рабочий сайт вместе с исправлениями. Восстановленные страницы, предназначенные для поиска, не должны были получить случайный запрет обхода или индексации.
Проверили покупательские сценарии
На копии повторно открыли товары из разных категорий и обеих языковых версий. Сверили изображения, цены, остатки, характеристики и доступные варианты товаров. Проверили поиск, фильтры, сортировку и переходы между страницами каталога.
Отдельно проверили запросы, которые выполняются без полной перезагрузки страницы. Они не должны были попадать под правила перенаправления старых товарных URL.
Затем добавили товары в корзину и провели тестовое оформление. Проверили результат создания заказа, а не только сообщение в браузере. Ответы корзины и оформления не подменялись карточкой товара или главной страницей.
После этого повторили проверку исходных проблемных адресов, целей перенаправлений и выбранных отсутствующих карточек. В испытанных сценариях прежняя неисправность не воспроизвелась. Это стало основанием для переноса исправлений на действующий магазин.
Внедрили изменения без замены рабочей базы
Перед внедрением сохранили актуальную резервную копию файлов, базы и конфигурации. При этом возврат всей базы к состоянию до миграции не входил в способ исправления: магазин уже принимал новые заказы, а товарные и клиентские данные продолжали изменяться.
Подготовили отдельный набор правок SEO-соответствий, маршрутизации, перенаправлений и связанных настроек. Перед применением повторно сверили его с текущей базой, чтобы не восстановить уже удалённый товар, не создать конфликт и не перезаписать более позднее изменение.
Для отмены внедрения сохранили исходное состояние затронутых записей и правил. Возврат этих правок не требовал замены всей базы и потери заказов, поступивших за время работ.
После применения обновили относящиеся к изменениям кеши и снова проверили ответы рабочего сайта. Вернулись к исходному списку URL: для каждого проверяли статус, конечный адрес, товар и язык. Дополнительно сверили внутренние ссылки, canonical, языковые связи и карту сайта.
Для первой группы подтвердили прямое открытие восстановленных основных адресов: HTTP 200, нужный товар и соответствующий язык. Для второй — переход со старого URL через 301 на действующую карточку с HTTP 200. У проверенных удалённых карточек без замены сохранялся ответ 404. В исследованных цепочках не обнаружили циклов и прежних переходов на главную вместо товара.
На рабочем магазине также повторили контроль каталога, языкового переключения, корзины и оформления. Проверка не выявила нарушения этих сценариев из-за внесённых правил.

Зафиксировали технический результат и дальнейшее наблюдение
Обновлённую карту сайта отправили в Search Console. Список исправленных адресов сохранили для дальнейшей проверки ответов сервера, повторного обхода и состояния индексации.
С владельцем отдельно обсудили результат работ. Мы восстановили доступность карточек и правильную обработку известных старых ссылок. Мгновенное возвращение поискового трафика в этот результат не включали: обработка перенаправлений и выбор канонических страниц поисковой системой происходят отдельно от изменения конфигурации магазина.
Для наблюдения использовали прежние и актуальные URL затронутых товаров. Одно только уменьшение переходов на старый адрес не считали повторным сбоем, если он уже был заменён перенаправлением на новую карточку. Состояние конечной страницы и её поисковые данные рассматривали вместе с прежним URL.
Перенаправления оставили частью рабочей конфигурации. Их не планировали удалять сразу после первой успешной проверки или изменения отчётов Search Console: прежние ссылки продолжали встречаться в поиске, закладках и на других страницах.
В исследованных случаях мы обнаружили пропущенные товарные SEO-соответствия и старые пути, которые после изменения структуры остались без перехода на новые карточки. Для первой группы восстановление связей вернуло прямое открытие основных URL. Для второй точные перенаправления вернули покупателю доступ к тому же товару через прежнюю ссылку.
После этого согласовали внутренние ссылки, языковые версии и карту сайта с выбранными основными адресами. Правки внедрили отдельно от заказов и остальных текущих данных магазина.
