Перед добавлением синонимов решите, должны ли слова заменять друг друга в обе стороны. Запись эквивалентности подходит для двух названий одного понятия; направленное правило — для приведения нескольких вариантов к выбранной форме. Ошибка этого выбора расширяет выдачу сильнее, чем ожидает редактор словаря. Начните с одной пары и искусственного мини-каталога.

Откройте настройки поля, по которому реально ищет приложение, и определите поисковый анализатор — цепочку преобразования запроса в токены. Проверка другого анализатора в консоли ничего не доказывает. Ожидаемый результат теста: нужный документ добавился, а контрольный документ с похожим, но другим смыслом не получил необоснованного совпадения.

Две записи, два разных обещания

Условные правила тестового словаря:
ноутбук, лэптоп
беспроводная мышка => беспроводная мышь

Вопрос для проверки:
должна ли обратная формулировка расширяться так же?

Актуальная инструкция Elastic различает эквивалентные правила через запятую и явные направленные отображения через =>. Для многословных синонимов в поисковом анализаторе рекомендован synonym_graph. Наборы синонимов, создаваемые через API или интерфейс Kibana, используются во время поиска. Проверено 14 октября 2026 года. Доступность управления и конкретную настройку сверяйте с версией и способом развёртывания своего кластера.

СитуацияРешение словаряКонтрольный вопрос
Два имени одного понятияЭквивалентностьРазрешены ли обе стороны?
Приведение к канонической формеНаправленная заменаЧто происходит с обратным запросом?
Общая и частная категорияНе объявлять автоматически равнымиНе потеряется ли уточнение?
Разные товары с похожим названиемОставить раздельнымиНет ли ложного расширения?

Смотрите токены, затем выдачу

Проверка анализатора отвечает на вопрос, какое преобразование произошло. Проверка выдачи отвечает, помогло ли оно пользователю. Сохраните исходный запрос, выбранное поле, анализатор и полученные токены на стенде. После этого выполните тот же запрос через приложение: оно может добавлять фильтры, выбирать другое поле или вообще использовать точное сравнение вместо полнотекстового поиска.

  • Прямой запрос должен находить согласованный документ.
  • Обратный запрос соответствует выбранному направлению.
  • Многословная фраза не теряет значимое уточнение.
  • Контрольный посторонний товар не становится равнозначным.
  • Фильтры доступности продолжают действовать.

Условный пример: редактор хочет связать разговорное название устройства с официальным, но добавляет к нему название всей категории. В выдачу попадают все устройства категории. Исправление — уточнить смысл правила и оставить проверку отрицательных примеров, а не компенсировать слишком широкое расширение постоянно растущими весами конкретных товаров.

Порядок фильтров анализатора имеет значение. Например, удаление стоп-слов может менять разбор многословного правила. Документация Elastic отдельно предупреждает о взаимодействии синонимов со stop-фильтром и об ошибках невалидных правил. Поэтому новый словарь сначала проверяется на тестовом индексе с той же цепочкой обработки, что у рабочего поля.

Обновление словаря — отдельный выпуск

Поисковые синонимы удобны тем, что их можно обновлять без полной переиндексации при поддерживаемой конфигурации. Это не универсальное обещание для любого фильтра и способа хранения. Не переносите процедуру обновления API-набора на файл без проверки документации. Держите исходный словарь, его ревизию, результат проверки и способ возврата предыдущего набора вместе.

Если часть правил не загрузилась, не объявляйте выпуск успешным только по доступности кластера. Сопоставьте принятый набор с ожидаемым и повторите запросы, ради которых делалось изменение. При откате возвращается согласованный словарь и проверяется фактическая выдача; старые результаты из прикладного кеша не должны скрывать состояние поискового анализатора.

Следующий полезный шаг — небольшой набор пар «запрос — ожидаемый товар» и отрицательных примеров для каждого нового правила. Для помощи с конкретным словарём достаточно обезличенного mapping, цепочки анализатора, версии Elasticsearch и спорной пары терминов. Пользовательские журналы целиком и доступ к рабочему кластеру для первичного разбора не нужны.

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