Перевод названия на странице не означает, что он попал в поисковый индекс. Когда товар не находится на другом языке, сначала проследите одну тестовую сущность: запись перевода, индексируемое поле и поле, по которому реально ищет запрос. Только после этого исследуйте анализатор — компонент, который превращает текст в поисковые токены.
Создайте небольшой стендовый набор с одним товаром и разными языковыми названиями. Сохраните ожидаемые запросы и результаты. Не переиндексируйте весь рабочий каталог ради первой гипотезы: это меняет слишком много условий и может затронуть доступность поиска. Далее рассматривается Elasticsearch; для другой системы нужен её собственный контракт анализа.
Перевод проходит три контрольные точки
| Этап | Что сравнить | Если не совпало |
|---|---|---|
| Источник | Опубликованный перевод конкретной сущности | Разобрать статус и экспорт данных |
| Индекс | Нужное языковое поле документа | Проверить преобразование и обновление |
| Запрос | Поле и язык фактического поиска | Исправить выбор поля до анализа |
| Отображение | Перевод найденного товара | Не путать поиск с подписью результата |
Условный пример: интерфейс показывает английское название, но запрос всё ещё направлен в поле русского названия. Пустая выдача ожидаема для части запросов. Другой случай — поле выбрано правильно, но импорт сохранил туда исходный текст. Настройка нечёткости не добавит отсутствующий перевод и может лишь принести случайные совпадения.
Токены сравниваем с фактической настройкой поля
Документация Elastic описывает встроенные языковые анализаторы с языковыми стоп-словами и обработкой словоформ. Их состав зависит от языка. Источник проверен 13 октября 2026 года. Выбор языка анализа должен соответствовать данным и контракту поиска; статья не предлагает один универсальный анализатор для всех письменностей и всех названий.
Analyze API показывает токены предоставленного текста. При указании field нужен индекс; явно заданный analyzer имеет приоритет над field. Источник Elastic проверен 13 октября 2026 года. Поэтому удобный тест с произвольным анализатором не обязательно воспроизводит настройки вашего поля. Сверяйте также анализатор запроса, если он отличается от индексного.
Условный запрос только анализа на тестовом индексе:
POST /demo_catalog/_analyze
{
"field": "name_en",
"text": "test product name"
}
Индекс и поле условные. Нужны разрешённый
доступ и сверка API установленной версии.Сопоставьте полученные токены для индексируемого названия и запроса с выбранной схемой анализа. Не обещайте совпадение по каждому слову: стоп-слова, нормализация и модель запроса меняют поведение. На контрольном корпусе объясните, какие запросы должны находить товар и почему. Отдельно включите отрицательный пример, который не должен возвращать эту сущность.
Артикулы и коды не обязаны проходить ту же языковую обработку, что названия. В согласованной модели можно дать им отдельный путь точного поиска. Не переводите технический идентификатор и не смешивайте резервное название с опубликованным переводом без явного правила. Для каждой выдачи должен оставаться понятным язык отображаемого результата.
Выпуск подтверждаем корпусом запросов
- Проверить одну сущность от источника до индекса.
- Сравнить фактический выбор языкового поля.
- Испытать токены названия и запроса.
- Прогнать ожидаемые и отрицательные запросы по языкам.
- Проверить обновление перевода и повторный импорт.
Обновление индекса может приходить позже редакционной публикации. Испытайте этот промежуток и предусмотренное состояние, не выдавая задержку за потерянные данные. Кеш выдачи должен различать согласованный языковой контекст. При параллельном редактировании переводов сохраняйте ревизию, чтобы устаревшее событие не вернуло старое название после нового.
Изменение схемы рабочего индекса требует отдельного плана выпуска и возврата; проверка токенов не выполняет миграцию. Сохраните mapping, настройки анализа и контрольный корпус без персональных данных. Передача готова, когда видно, где потерялся язык: в экспорте, индексном поле, запросе или показе результата. Это основание для адресного исправления, а не для бесконечного расширения fuzzy-поиска.