---
title: Dépannage
description: Échecs de démarrage, réponses d'erreur et résultats inattendus de Human Plugin, avec la cause et la solution pour chacun.
canonical: https://developer.unico.io/fr/human-plugin/additional-resources/troubleshooting
locale: fr
generated_by: markdown-export
---

# Dépannage

Symptôme, cause et marche à suivre.

## Le conteneur ne démarre pas

| Message de log (résumé) | Cause | Solution |
| --- | --- | --- |
| Reading config | `POSTGRES_ADDRESS_HOST`, `POSTGRES_PASSWORD` ou `HUMAN_API_ACCESS_KEY` est absente ou vide | Définissez-la |
| `POSTGRES_PASSWORD must not contain…` | Espace, guillemet, barre oblique inverse ou caractères de contrôle | Utilisez un autre mot de passe |
| Toute autre variable nommée dans l'erreur | Une variable hors de la [configuration prise en charge](/fr/human-plugin/self-hosting/configuration) a été définie | Supprimez-la |
| Downloading attribute catalog | Sortie vers `human-token-assets.unico.app` bloquée, ou aucune réponse en 10 secondes | Autorisez le trafic HTTPS sortant vers cet hôte |
| `database "…" does not exist` | La base indiquée dans `POSTGRES_DATABASE`, `human_plugin` par défaut, n'a pas été créée | Créez la base, ou définissez `POSTGRES_DATABASE` avec celle que vous avez créée |
| Connecting to or preparing the database | PostgreSQL inaccessible, identifiants ou mode SSL incorrects, ou le rôle ne peut pas créer de tables | Vérifiez la [connexion à la base de données](/fr/human-plugin/self-hosting/configuration#database-connection) et les permissions du rôle |

## Requêtes

| Symptôme | Cause | Solution |
| --- | --- | --- |
| `401` avec `{"message":"","details":[]}` | Unico a refusé la clé d'accès : absente, incorrecte ou plus valide | Vérifiez `HUMAN_API_ACCESS_KEY` et redémarrez Human Plugin. Si la clé est correcte, demandez à Unico de confirmer qu'elle est activée |
| `400 MISSING_CREDENTIAL_TYPE` | `credential` est absent, ou est un objet avec des chaînes vides | Envoyez un document, ou `null` / `{}` |
| `400 INVALID_REQUEST` avec un corps d'apparence valide | Un champ réservé par Human Plugin, une autre orthographe de `clientId`, `correlationId` ou `credential` (comme `client_id`), ou une valeur non textuelle dans l'un d'eux | Utilisez les noms de champs exacts de [Créer un processus](/fr/human-plugin/api-reference/create-process) |
| `400 INVALID_CLIENT_ID` (ou un autre champ) | Limite d'octets dépassée, caractères de contrôle ou espaces en début ou fin de valeur | Supprimez les espaces et raccourcissez |
| `400 REQUEST_TOO_LARGE` | Corps supérieur à 2 MiB | Réduisez la taille de l'image |
| `409 CORRELATION_ID_ALREADY_USED` | Un autre processus a déjà ce `correlationId`, y compris un processus en échec | Envoyez un nouveau `correlationId` unique |
| `422 ATTRIBUTE_TYPE_NOT_SUPPORTED` | Code absent du catalogue, ou casse incorrecte | Utilisez un code exact du catalogue |
| `4xx` avec un `message` inconnu | Le flux a refusé la requête : le flux, l'image ou un champ du flux | Voir [Refus](/fr/human-plugin/api-reference/create-process#flow-refusals) |
| `502 UPSTREAM_UNAVAILABLE` à chaque création | Trafic HTTPS sortant bloqué | Vérifiez la [sortie réseau](/fr/human-plugin/self-hosting/networking-and-security) et la clé d'accès. Pour les nouvelles tentatives, voir [Erreurs et nouvelles tentatives](/fr/human-plugin/api-reference/errors-and-retries) |
| `503 DATABASE_UNAVAILABLE` | PostgreSQL inaccessible | Vérifiez la base de données. La vérification de disponibilité (readiness) échoue aussi |
| `404 PROCESS_NOT_FOUND` pour un processus connu | Mauvaise installation ou base de données, ou identifiant mal formé | Confirmez l'identifiant et l'instance de Human Plugin que vous appelez |

## Résultats

| Symptôme | Cause |
| --- | --- |
| `PROCESS_STATE_FINISHED` mais la personne ne correspond pas | « Terminé » inclut un résultat négatif. Lisez `data` |
| `data.ndocs` absent | Non terminé, capture non vivante, correspondance négative, ou l'intelligence n'a pas pu être calculée. Relisez. Voir [Intelligence](/fr/human-plugin/get-started/intelligence) |
| `token` / `link` du parcours absents sur `GET` | Ils ne sont renvoyés qu'à la création |
| `PROCESS_STATE_FAILED` avec `data: {}` | Le processus s'est terminé sans résultat. Voir [Cycle de vie du processus](/fr/human-plugin/api-reference/process-lifecycle) |
| Un processus en attente n'avance jamais | Seul un `GET` le met à jour. Interrogez-le régulièrement |