---
title: Устранение неполадок
description: 'Сбои при запуске, ответы с ошибками и неожиданные результаты в Human Plugin: причина и способ исправления для каждого случая.'
canonical: https://developer.unico.io/ru/human-plugin/additional-resources/troubleshooting
locale: ru
generated_by: markdown-export
---

# Устранение неполадок

Симптом, причина и что делать.

## Контейнер не запускается

| Сообщение в логе (кратко) | Причина | Решение |
| --- | --- | --- |
| Reading config | `POSTGRES_ADDRESS_HOST`, `POSTGRES_PASSWORD` или `HUMAN_API_ACCESS_KEY` отсутствует или пуст | Задайте его |
| `POSTGRES_PASSWORD must not contain…` | Пробельные символы, кавычки, обратная косая черта или управляющие символы | Используйте другой пароль |
| Любая другая переменная, названная в ошибке | Задана переменная, которой нет в [поддерживаемой конфигурации](/ru/human-plugin/self-hosting/configuration) | Удалите её |
| 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, либо у роли нет прав на создание таблиц | Проверьте [подключение к базе данных](/ru/human-plugin/self-hosting/configuration#database-connection) и права роли |

## Запросы

| Симптом | Причина | Решение |
| --- | --- | --- |
| `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`) либо нестроковое значение в одном из них | Используйте точные имена полей из раздела [Создание процесса](/ru/human-plugin/api-reference/create-process) |
| `400 INVALID_CLIENT_ID` (или другое поле) | Превышен лимит в байтах, есть управляющие символы или пробелы по краям | Уберите пробелы и сократите значение |
| `400 REQUEST_TOO_LARGE` | Тело больше 2 MiB | Уменьшите размер изображения |
| `409 CORRELATION_ID_ALREADY_USED` | У другого процесса уже есть такой `correlationId`, включая завершившийся ошибкой | Отправьте новый уникальный `correlationId` |
| `422 ATTRIBUTE_TYPE_NOT_SUPPORTED` | Кода нет в каталоге либо неверный регистр | Используйте точный код из каталога |
| `4xx` с незнакомым `message` | Поток отклонил запрос: из-за потока, изображения или поля потока | См. [Отказы](/ru/human-plugin/api-reference/create-process#flow-refusals) |
| `502 UPSTREAM_UNAVAILABLE` при каждом создании | Исходящий HTTPS заблокирован | Проверьте [исходящий трафик](/ru/human-plugin/self-hosting/networking-and-security) и ключ доступа. О повторных попытках см. [Ошибки и повторные попытки](/ru/human-plugin/api-reference/errors-and-retries) |
| `503 DATABASE_UNAVAILABLE` | PostgreSQL недоступен | Проверьте базу данных. Проверка готовности тоже не проходит |
| `404 PROCESS_NOT_FOUND` для известного процесса | Не та установка или база данных либо неверный формат id | Проверьте id и то, какой именно Human Plugin вы вызываете |

## Результаты

| Симптом | Причина |
| --- | --- |
| `PROCESS_STATE_FINISHED`, но человек не совпал | Состояние Finished включает и отрицательный исход. Прочитайте `data` |
| Нет `data.ndocs` | Процесс не завершён, это неживой захват, совпадения нет или аналитику не удалось вычислить. Прочитайте процесс ещё раз. См. [Аналитика](/ru/human-plugin/get-started/intelligence) |
| В `GET` нет `token` / `link` из Journey | Они возвращаются только при создании |
| `PROCESS_STATE_FAILED` с `data: {}` | Процесс завершился без результата. См. [Жизненный цикл процесса](/ru/human-plugin/api-reference/process-lifecycle) |
| Процесс в ожидании не продвигается | Обновить его может только `GET`. Опрашивайте процесс |