Устранение неполадок
Симптом, причина и что делать.
Контейнер не запускается
| Сообщение в логе (кратко) | Причина | Решение |
|---|---|---|
| Reading config | POSTGRES_ADDRESS_HOST, POSTGRES_PASSWORD или HUMAN_API_ACCESS_KEY отсутствует или пуст | Задайте его |
POSTGRES_PASSWORD must not contain… | Пробельные символы, кавычки, обратная косая черта или управляющие символы | Используйте другой пароль |
| Любая другая переменная, названная в ошибке | Задана переменная, которой нет в поддерживаемой конфигурации | Удалите её |
| Downloading attribute catalog | Исходящий трафик к human-token-assets.unico.app заблокирован или ответа нет в течение 10 секунд | Разрешите исходящий HTTPS к нему |
database "…" does not exist | База данных, указанная в POSTGRES_DATABASE (по умолчанию human_plugin), не создана | Создайте базу данных или укажите в POSTGRES_DATABASE ту, что вы создали |
| Connecting to or preparing the database | PostgreSQL недоступен, неверные учётные данные или режим SSL, либо у роли нет прав на создание таблиц | Проверьте подключение к базе данных и права роли |
Запросы
| Симптом | Причина | Решение |
|---|---|---|
401 с {"message":"","details":[]} | Unico отклонил ключ доступа: он отсутствует, неверен или больше недействителен | Проверьте HUMAN_API_ACCESS_KEY и перезапустите Human Plugin. Если ключ верный, попросите Unico подтвердить, что он включён |
400 MISSING_CREDENTIAL_TYPE | credential отсутствует или является объектом с пустыми строками | Передайте документ либо null / {} |
400 INVALID_REQUEST при внешне корректном теле | Поле, зарезервированное Human Plugin, другое написание clientId, correlationId или credential (например, client_id) либо нестроковое значение в одном из них | Используйте точные имена полей из раздела Создание процесса |
400 INVALID_CLIENT_ID (или другое поле) | Превышен лимит в байтах, есть управляющие символы или пробелы по краям | Уберите пробелы и сократите значение |
400 REQUEST_TOO_LARGE | Тело больше 2 MiB | Уменьшите размер изображения |
409 CORRELATION_ID_ALREADY_USED | У другого процесса уже есть такой correlationId, включая завершившийся ош ибкой | Отправьте новый уникальный correlationId |
422 ATTRIBUTE_TYPE_NOT_SUPPORTED | Кода нет в каталоге либо неверный регистр | Используйте точный код из каталога |
4xx с незнакомым message | Поток отклонил запрос: из-за потока, изображения или поля потока | См. Отказы |
502 UPSTREAM_UNAVAILABLE при каждом создании | Исходящий HTTPS заблокирован | Проверьте исходящий трафик и ключ доступа. О повторных попытках см. Ошибки и повторные попытки |
503 DATABASE_UNAVAILABLE | PostgreSQL недоступен | Проверьте базу данных. Проверка готовности тоже не проходит |
404 PROCESS_NOT_FOUND для известного процесса | Не та установка или база данных либо неверный формат id | Проверьте id и то, какой именно Human Plugin вы вызываете |
Результаты
| Симптом | Причин а |
|---|---|
PROCESS_STATE_FINISHED, но человек не совпал | Состояние Finished включает и отрицательный исход. Прочитайте data |
Нет data.ndocs | Процесс не завершён, это неживой захват, совпадения нет или аналитику не удалось вычислить. Прочитайте процесс ещё раз. См. Аналитика |
В GET нет token / link из Journey | Они возвращаются только при создании |
PROCESS_STATE_FAILED с data: {} | Процесс завершился без результата. См. Жизненный цикл процесса |
| Процесс в ожидании не продвигается | Обновить его может только GET. Опрашивайте процесс |