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 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 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 |
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 |
502 UPSTREAM_UNAVAILABLE à chaque création | Trafic HTTPS sortant bloqué | Vérifiez la sortie réseau et la clé d'accès. Pour les nouvelles tentatives, voir Erreurs et nouvelles tentatives |
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 |
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 |
| Un processus en attente n'avance jamais | Seul un GET le met à jour. Interrogez-le régulièrement |