Ошибки индексации

Индексация отделена от индексирования: запись попадает в SearchIngestBuffer, воркер забирает её и применяет к живому индексу. «Сбой» может означать 4xx на границе API, 4xx у воркера или зависшую очередь. Для каждого — своё решение.

Симптомы

Дерево решений

API вернул 2xx?
  ├─ нет  → исправьте тело запроса; см. "Ошибки валидации" ниже
  └─ да  → проверьте глубину очереди буфера
            ├─ глубина 0 → воркер обработал; проверьте соответствие схемы
            └─ глубина > 0 → ждите; см. "Задержка очереди" ниже

Проверка 1: ответ API

Успешная постановка в очередь возвращает { "enqueued": <n>, "errors": [] }. Частичный успех возвращает ошибки по документам:

{
  "enqueued": 998,
  "errors": [
    {
      "external_id": "product-123",
      "error": "validation_failed",
      "message": "Field 'price' expected float, got string"
    },
    {
      "external_id": "product-456",
      "error": "missing_field",
      "message": "Required field 'title' is missing"
    }
  ]
}

Исправьте каждую строку согласно её коду error. Остальные 998 уже на пути к индексу.

Частые ошибки валидации

Проверка 2: глубина очереди буфера

Если API ответил enqueued: N, но документы не видны через 2 минуты, проверьте очередь:

curl -X GET https://app.aacsearch.com/api/v1/projects/<projectId>/usage \
  -H "Authorization: Bearer aa_admin_..."

Ответ включает bufferDepth для организации. Здоровая глубина — < 1000 большую часть времени. Устойчивая глубина > 50 000 указывает на троттлинг воркера.

Проверка 3: несоответствие схемы

Документ может пройти валидацию на границе, но быть отклонён воркером, если тип поля изменился с момента установки схемы индекса. Отклонения воркера отображаются в дашборде:

Поиск → Индексы → индекс → вкладка «Recent ingest errors».

Частые причины:

• Коннектор начал отправлять новое поле, для которого нет определения фасета/типа.
• Поле изменилось с string на string[] в источнике.
• Вложенный объект был сплющен не так, как ожидает схема.

Обновите схему (admin API → PATCH /v1/indexes/<id>) и повторно отправьте затронутые документы.

Проверка 4: выполняется переиндексация

Во время полной переиндексации живой псевдоним подменяется в конце. Пока переиндексация выполняется, новые записи пишутся в обе коллекции — старую и новую. Записи не теряются, но вы можете наблюдать временную задержку.

Проверьте Поиск → Индексы → статус. Если статус reindexing, дождитесь завершения. См. переиндексация и нулевой простой для полного жизненного цикла.

Проверка 5: особенности коннектора

Если вы используете коннектор (PrestaShop, Bitrix, Postgres-sync), проверьте последнюю задачу синхронизации коннектора:

curl -X GET https://app.aacsearch.com/api/v1/projects/<projectId>/sync-jobs \
  -H "Authorization: Bearer aa_admin_..."

Каждая строка имеет статус: pending, running, completed, failed. Упавшие задачи включают базовую ошибку и пример документа, на котором произошёл сбой.

Давление: воркер затроттлен

Если bufferDepth растёт до сотен тысяч и не уменьшается, происходит одно из следующего:

Матрица решений

Диагностический пакет

Связанные страницы

• Жизненный цикл API коннектора — справочник эндпоинтов
• Синхронизация коннектора — проблемы, специфичные для коннектора
• Переиндексация и нулевой простой
• Ошибки аутентификации — для 401/403 на эндпоинтах индексации