Устранение неполадок: ошибка поиска 425

При использовании расширенного поиска в HTML-файлах, экспортированных из Dr.Explain, вместо результатов поиска вы можете столкнуться с сообщениями об ошибках с кодом 425.

Ошибка 425 означает, что поисковый индекс обновляется и ещё не готов к работе. Это нормальная ситуация, если контент на сервере недавно изменился.

Наиболее вероятные причины

Индексация все еще выполняется: это нормально. Для документаций с большим количеством разделов необходимо подождать 5–10 минут.
Медленная работа службы Solr: увеличьте лимиты CPU или памяти для сервиса Solr.
Большой индекс: дайте больше времени на завершение индексации.
Система перегружена: другие процессы могут использовать ресурсы системы.

Шаг 1: Подождите несколько минут

Индексация требует времени, особенно если в документации большое количество разделов.

Что нужно сделать:

Подождать 5 минут.
Повторить поиск.

Если по истечении 5 минут ошибка не исчезла: перейдите к Шагу 2.

Шаг 2: Проверьте логи бэкенда

Этот шаг требует доступа к вашему серверу через SSH и Docker.

Выполните команду:

docker compose logs drexplain-search-backend-controller

Обратите внимание на следующие сообщения:

"Sending file xxx.htm to index" — в данный момент бэкенд индексирует файлы. Это нормально. Подождите ещё несколько минут.
"Successfully sent file xxx.htm" — файлы отправлены в индекс. Если это сообщение повторяется длительное время, возможно, служба Solr работает медленно. Перейдите к Шагу 3.
"Finished updating search index" — индексация завершена. Попробуйте повторить поиск.

Если кажется, что индексация зависла: перейдите к Шагу 3.

Шаг 3: Проверьте ресурсы Solr

Этот шаг требует доступа к вашему серверу по SSH и к Docker.

Проверьте, не использует ли Solr слишком много процессорных ресурсов или памяти:

docker compose stats

Обратите внимание на: контейнер Solr, показывающий высокое использование CPU (близкое к 100%) или памяти.

Если Solr испытывает нехватку ресурсов: возможно, вашей системе не хватает ресурсов или лимит CPU слишком низкий. Проверьте ваш файл docker-compose.yaml:

solr:

deploy:

resources:

limits:

cpus: '2.0' # Должно быть не менее 1.0 для приемлемой производительности

Если лимит CPU очень низкий (например, 0.5): увеличьте его как минимум до 1.0 или выше.

Шаг 4: Проверьте наличие ошибок

Этот шаг требует доступа к вашему серверу через SSH и Docker.

Проверьте наличие ошибок в логах:

docker compose logs drexplain-search-backend-controller | grep -i error

docker compose logs solr | grep -i error

Если вы видите ошибки: устраните ошибки, указанные в логах.