Типовые симптомы и решения

Источник не собирает письма

Признак: карточка источника или задача сбора показывает ошибку.
Проверьте: учётные данные, адрес сервера, порт и сетевую доступность.
Действие: исправьте параметры, нажмите [Проверить], затем [Сохранить] и запустите сбор повторно.

Поиск не находит письма

Признак: письмо видно в архиве, но полнотекстовый поиск его не находит.
Проверьте: [Самопроверка], очередь индексирования и состояние Solr.
Действие: восстановите доступность поиска и дождитесь обработки очереди. При необходимости выполните {{ССЫЛКА:maintenance.search-reindex|переиндексацию архива}}.

Распознавание текста не работает

Признак: поиск не находит текст внутри сканов или изображений.
Проверьте: включено ли OCR, назначена ли роль индексирования и установлены ли нужные языковые пакеты.
Действие: исправьте настройки на странице {{ССЫЛКА:install.ocr|Распознавание текста (OCR)}} и повторите индексирование.

Перераспределение хранилища не завершается

Признак: дочерние задачи перераспределения остаются в очереди или завершаются с ошибкой.
Проверьте: доступность целевых узлов и наличие роли [Хранилище].
Действие: восстановите узел или скорректируйте состав группы, затем повторите операцию. См. {{ССЫЛКА:maintenance.storage-health|Проверка состояния хранилищ}}.

Инстанс Solr недоступен или есть проблемные реплики

Признак: в [Инстансы SolrCloud] узел недоступен или отображаются проблемные реплики.
Действие: проверьте контейнер Solr и соединение с кластером. После восстановления проверьте число реплик. См. {{ССЫЛКА:maintenance.search-health|Проверка состояния поиска}}.

IMAP не работает

Признак: почтовый клиент не подключается или не видит архив.
Проверьте: учётную запись, состояние IMAP-службы, TLS и сетевую доступность.
Действие: используйте {{ССЫЛКА:install.imap-service|настройку IMAP-сервера}} и {{ССЫЛКА:reference.imap|справочник IMAP}}.

Пул соединений PostgreSQL исчерпан

Признак: на панели состояния число занятых соединений близко к пределу; запросы к базе завершаются ошибкой или ожидают.
Действие: выполните {{ССЫЛКА:maintenance.db-pool|процедуру при исчерпании пула соединений}}.

Задача зависла

Признак: задача долго не меняет состояние и не показывает прогресс.
Действие: откройте {{ССЫЛКА:maintenance.tasks|Очередь задач}}, проверьте дочерние задачи и журнал. Остановите и перезапустите задачу только после определения причины.

Оповещения не отправляются

Признак: очередь оповещений растёт.
Действие: откройте {{ССЫЛКА:install.notifications|Оповещения}}, проверьте SMTP-сервер и нажмите [Отправить тестовое письмо].

Массовый сбор завершён с ошибками по части адресов

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

Сбор Microsoft Exchange через EWS прерывается

Проверьте учётные данные, права доступа, сетевое соединение и ограничения Exchange. Для повторяющихся ошибок сопоставьте код с {{ССЫЛКА:reference.errors-index|справочником кодов ошибок}}.

Индексирование выполняется медленно

Проверьте размер очереди, загрузку узлов индексирования, доступность Solr и параметры индексирования. Не изменяйте внутренние параметры или исходный код по рекомендациям из старых версий документации. Используйте {{ССЫЛКА:maintenance.search-performance|настройку производительности индексирования}}.

В поиске отображаются дубликаты писем

Проверьте версию Клавдия и установите актуальное исправление, если проблема воспроизводится на старом выпуске.
Выполните переиндексацию только после устранения причины. Переиндексация сама по себе не удаляет дублирующиеся записи из базы.
Не удаляйте строки базы вручную. Для очистки данных используйте подтверждённую процедуру для вашей версии или обратитесь в техническую поддержку.

Встроенные изображения письма не отображаются

Проверьте, что вложения письма доступны и имеют корректный Content-ID. Если проблема воспроизводится после обновления, сохраните исходное сообщение EML и передайте его в техническую поддержку.

Не индексируется содержимое архива ZIP

Индексирование вложенных архивов ограничивает глубину, число файлов, размер распакованных данных и степень сжатия для защиты от архивных бомб. Зашифрованные архивы без пароля не индексируются. Если лимит сработал, само письмо остаётся в архиве; измените структуру вложения и выполните переиндексацию. Ограничения конкретной версии проверьте в {{ССЫЛКА:reference.limitations|Ограничениях текущей версии}}.

Навигация по книге

Следующая статья: {{ССЫЛКА:maintenance.cli|Утилиты командной строки}}