---
title: Solução de problemas
description: Falhas de inicialização, respostas de erro e resultados inesperados no Human Plugin, com a causa e a correção de cada um.
canonical: https://developer.unico.io/pt-BR/human-plugin/additional-resources/troubleshooting
locale: pt-BR
generated_by: markdown-export
---

# Solução de problemas

Sintoma, causa e o que fazer.

## O contêiner não inicia

| Mensagem de log (resumo) | Causa | Correção |
| --- | --- | --- |
| Reading config | `POSTGRES_ADDRESS_HOST`, `POSTGRES_PASSWORD` ou `HUMAN_API_ACCESS_KEY` está ausente ou vazia | Defina a variável |
| `POSTGRES_PASSWORD must not contain…` | Espaço em branco, aspas, barra invertida ou caracteres de controle | Use outra senha |
| Qualquer outra variável citada no erro | Foi definida uma variável fora da [configuração suportada](/pt-BR/human-plugin/self-hosting/configuration) | Remova a variável |
| Downloading attribute catalog | Saída para `human-token-assets.unico.app` bloqueada, ou sem resposta em 10 segundos | Libere o HTTPS de saída para ele |
| `database "…" does not exist` | O banco indicado em `POSTGRES_DATABASE`, `human_plugin` por padrão, não foi criado | Crie o banco ou defina `POSTGRES_DATABASE` com o que você criou |
| Connecting to or preparing the database | PostgreSQL inacessível, credenciais ou modo SSL incorretos, ou o role não pode criar tabelas | Verifique a [conexão com o banco de dados](/pt-BR/human-plugin/self-hosting/configuration#database-connection) e as permissões do role |

## Requisições

| Sintoma | Causa | Correção |
| --- | --- | --- |
| `401` com `{"message":"","details":[]}` | A Unico recusou a chave de acesso: ausente, incorreta ou não mais válida | Verifique `HUMAN_API_ACCESS_KEY` e reinicie o Human Plugin. Se a chave estiver certa, peça à Unico para confirmar que ela está habilitada |
| `400 MISSING_CREDENTIAL_TYPE` | `credential` está ausente, ou é um objeto com strings vazias | Envie um documento, ou `null` / `{}` |
| `400 INVALID_REQUEST` com um corpo aparentemente válido | Um campo reservado pelo Human Plugin, outra grafia de `clientId`, `correlationId` ou `credential` (como `client_id`), ou um valor que não é string em um deles | Use os nomes exatos dos campos de [Criar um processo](/pt-BR/human-plugin/api-reference/create-process) |
| `400 INVALID_CLIENT_ID` (ou outro campo) | Acima do limite de bytes, caracteres de controle ou espaços nas extremidades | Remova os espaços e reduza o tamanho |
| `400 REQUEST_TOO_LARGE` | Corpo acima de 2 MiB | Reduza o tamanho da imagem |
| `409 CORRELATION_ID_ALREADY_USED` | Outro processo já tem esse `correlationId`, inclusive um que falhou | Envie um novo `correlationId`, único |
| `422 ATTRIBUTE_TYPE_NOT_SUPPORTED` | Código fora do catálogo, ou com maiúsculas/minúsculas incorretas | Use um código exato do catálogo |
| `4xx` com um `message` desconhecido | O fluxo recusou a requisição: o fluxo, a imagem ou um campo do fluxo | Veja [Recusas](/pt-BR/human-plugin/api-reference/create-process#flow-refusals) |
| `502 UPSTREAM_UNAVAILABLE` em toda criação | HTTPS de saída bloqueado | Verifique a [saída de rede](/pt-BR/human-plugin/self-hosting/networking-and-security) e a chave de acesso. Para novas tentativas, veja [Erros e novas tentativas](/pt-BR/human-plugin/api-reference/errors-and-retries) |
| `503 DATABASE_UNAVAILABLE` | PostgreSQL inacessível | Verifique o banco de dados. A verificação de prontidão também falha |
| `404 PROCESS_NOT_FOUND` para um processo conhecido | Instalação ou banco incorretos, ou id malformado | Confirme o id e qual Human Plugin você está chamando |

## Resultados

| Sintoma | Causa |
| --- | --- |
| `PROCESS_STATE_FINISHED`, mas a pessoa não correspondeu | Finalizado inclui um resultado negativo. Leia `data` |
| `data.ndocs` ausente | Não finalizado, captura sem prova de vida, correspondência negativa, ou não foi possível calcular a inteligência. Leia novamente. Veja [Inteligência](/pt-BR/human-plugin/get-started/intelligence) |
| `token` / `link` da jornada ausentes no `GET` | São devolvidos apenas na criação |
| `PROCESS_STATE_FAILED` com `data: {}` | O processo terminou sem resultado. Veja [Ciclo de vida do processo](/pt-BR/human-plugin/api-reference/process-lifecycle) |
| Um processo pendente nunca avança | Nada o atualiza, exceto um `GET`. Faça polling |