---
title: Solución de problemas
description: Fallos de arranque, respuestas de error y resultados inesperados en Human Plugin, con la causa y la solución de cada uno.
canonical: https://developer.unico.io/es/human-plugin/additional-resources/troubleshooting
locale: es
generated_by: markdown-export
---

# Solución de problemas

Síntoma, causa y qué hacer.

## El contenedor no arranca

| Mensaje del log (resumen) | Causa | Solución |
| --- | --- | --- |
| Reading config | Falta `POSTGRES_ADDRESS_HOST`, `POSTGRES_PASSWORD` o `HUMAN_API_ACCESS_KEY`, o está vacía | Defínala |
| `POSTGRES_PASSWORD must not contain…` | Espacios en blanco, comillas, barras invertidas o caracteres de control | Use otra contraseña |
| Cualquier otra variable citada en el error | Se definió una variable fuera de la [configuración admitida](/es/human-plugin/self-hosting/configuration) | Elimínela |
| Downloading attribute catalog | Salida hacia `human-token-assets.unico.app` bloqueada, o sin respuesta en 10 segundos | Permita HTTPS de salida hacia ese host |
| `database "…" does not exist` | La base de datos indicada en `POSTGRES_DATABASE`, `human_plugin` por defecto, no fue creada | Cree la base de datos, o defina `POSTGRES_DATABASE` con la que creó |
| Connecting to or preparing the database | PostgreSQL inaccesible, credenciales o modo SSL incorrectos, o el rol no puede crear tablas | Revise la [conexión a la base de datos](/es/human-plugin/self-hosting/configuration#database-connection) y los permisos del rol |

## Solicitudes

| Síntoma | Causa | Solución |
| --- | --- | --- |
| `401` con `{"message":"","details":[]}` | Unico rechazó la clave de acceso: falta, es incorrecta o ya no es válida | Revise `HUMAN_API_ACCESS_KEY` y reinicie Human Plugin. Si la clave es correcta, pida a Unico que confirme que está habilitada |
| `400 MISSING_CREDENTIAL_TYPE` | Falta `credential`, o es un objeto con cadenas vacías | Envíe un documento, o `null` / `{}` |
| `400 INVALID_REQUEST` con un cuerpo aparentemente válido | Un campo que Human Plugin reserva, otra grafía de `clientId`, `correlationId` o `credential` (como `client_id`), o un valor que no es cadena en alguno de ellos | Use los nombres de campo exactos de [Crear un proceso](/es/human-plugin/api-reference/create-process) |
| `400 INVALID_CLIENT_ID` (u otro campo) | Supera el límite de bytes, tiene caracteres de control o espacios en los extremos | Recorte y acorte el valor |
| `400 REQUEST_TOO_LARGE` | Cuerpo superior a 2 MiB | Reduzca el tamaño de la imagen |
| `409 CORRELATION_ID_ALREADY_USED` | Otro proceso ya tiene ese `correlationId`, incluso uno fallido | Envíe un `correlationId` nuevo y único |
| `422 ATTRIBUTE_TYPE_NOT_SUPPORTED` | Código que no está en el catálogo, o con mayúsculas y minúsculas incorrectas | Use un código exacto del catálogo |
| `4xx` con un `message` desconocido | El flujo rechazó la solicitud: el flujo, la imagen o un campo del flujo | Consulte [Rechazos](/es/human-plugin/api-reference/create-process#flow-refusals) |
| `502 UPSTREAM_UNAVAILABLE` en cada creación | HTTPS de salida bloqueado | Revise la [salida de red](/es/human-plugin/self-hosting/networking-and-security) y la clave de acceso. Para los reintentos, consulte [Errores y reintentos](/es/human-plugin/api-reference/errors-and-retries) |
| `503 DATABASE_UNAVAILABLE` | PostgreSQL inaccesible | Revise la base de datos. La comprobación de readiness también falla |
| `404 PROCESS_NOT_FOUND` para un proceso conocido | Instalación o base de datos equivocada, o un id mal formado | Confirme el id y a qué Human Plugin está llamando |

## Resultados

| Síntoma | Causa |
| --- | --- |
| `PROCESS_STATE_FINISHED` pero la persona no coincidió | Finalizado incluye un resultado negativo. Lea `data` |
| Falta `data.ndocs` | No finalizó, es una captura no viva, hubo una coincidencia negativa, o no fue posible calcular la inteligencia. Vuelva a leer. Consulte [Inteligencia](/es/human-plugin/get-started/intelligence) |
| Faltan `token` / `link` del Journey en `GET` | Solo se devuelven en la creación |
| `PROCESS_STATE_FAILED` con `data: {}` | El proceso terminó sin resultado. Consulte [Ciclo de vida del proceso](/es/human-plugin/api-reference/process-lifecycle) |
| Un proceso pendiente nunca avanza | Nada lo actualiza salvo un `GET`. Consúltelo periódicamente (polling) |