Fehlerbehebung
Symptom, Ursache und was zu tun ist.
Der Container startet nicht
| Log-Meldung (Zusammenfassung) | Ursache | Lösung |
|---|---|---|
| Reading config | POSTGRES_ADDRESS_HOST, POSTGRES_PASSWORD oder HUMAN_API_ACCESS_KEY fehlt oder ist leer | Setzen Sie die Variable |
POSTGRES_PASSWORD must not contain… | Leerzeichen, Anführungszeichen, Backslash oder Steuerzeichen | Verwenden Sie ein anderes Passwort |
| Jede andere im Fehler genannte Variable | Es wurde eine Variable gesetzt, die nicht zur unterstützten Konfiguration gehört | Entfernen Sie sie |
| Downloading attribute catalog | Egress zu human-token-assets.unico.app blockiert oder keine Antwort innerhalb von 10 Sekunden | Erlauben Sie ausgehendes HTTPS dorthin |
database "…" does not exist | Die in POSTGRES_DATABASE genannte Datenbank, standardmäßig human_plugin, wurde nicht angelegt | Legen Sie die Datenbank an oder setzen Sie POSTGRES_DATABASE auf die angelegte Datenbank |
| Connecting to or preparing the database | PostgreSQL nicht erreichbar, falsche Zugangsdaten oder falscher SSL-Modus, oder die Rolle darf keine Tabellen anlegen | Prüfen Sie die Datenbankverbindung und die Berechtigungen der Rolle |
Requests
| Symptom | Ursache | Lösung |
|---|---|---|
401 mit {"message":"","details":[]} | Unico hat den Access Key abgelehnt: fehlt, ist falsch oder nicht mehr gültig | Prüfen Sie HUMAN_API_ACCESS_KEY und starten Sie Human Plugin neu. Wenn der Key stimmt, bitten Sie Unico zu bestätigen, dass er aktiviert ist |
400 MISSING_CREDENTIAL_TYPE | credential fehlt oder ist ein Objekt mit leeren Strings | Senden Sie ein Dokument oder null / {} |
400 INVALID_REQUEST bei einem scheinbar gültigen Body | Ein von Human Plugin reserviertes Feld, eine andere Schreibweise von clientId, correlationId oder credential (etwa client_id) oder ein Wert in einem dieser Felder, der kein String ist | Verwenden Sie die exakten Feldnamen aus Prozess erstellen |
400 INVALID_CLIENT_ID (oder ein anderes Feld) | Byte-Limit überschritten, Steuerzeichen oder umgebende Leerzeichen | Kürzen und Leerzeichen entfernen |
400 REQUEST_TOO_LARGE | Body größer als 2 MiB | Verkleinern Sie das Bild |
409 CORRELATION_ID_ALREADY_USED | Ein anderer Prozess, auch ein fehlgeschlagener, hat bereits diese correlationId | Senden Sie eine neue, eindeutige correlationId |
422 ATTRIBUTE_TYPE_NOT_SUPPORTED | Code nicht im Katalog oder falsche Groß-/Kleinschreibung | Verwenden Sie einen exakten Code aus dem Katalog |
4xx mit unbekannter message | Der Flow hat die Anfrage abgelehnt: der Flow, das Bild oder ein Flow-Feld | Siehe Ablehnungen |
502 UPSTREAM_UNAVAILABLE bei jedem Create | Ausgehendes HTTPS blockiert | Prüfen Sie den Egress und den Access Key. Zu Wiederholungen siehe Fehler und Wiederholungen |
503 DATABASE_UNAVAILABLE | PostgreSQL nicht erreichbar | Prüfen Sie die Datenbank. Auch die Readiness schlägt fehl |
404 PROCESS_NOT_FOUND für einen bekannten Prozess | Falsche Installation oder Datenbank oder eine fehlerhafte ID | Bestätigen Sie die ID und welches Human Plugin Sie aufrufen |
Ergebnisse
| Symptom | Ursache |
|---|---|
PROCESS_STATE_FINISHED, aber die Person stimmte nicht überein | „Finished" umfasst auch ein negatives Ergebnis. Lesen Sie data |
data.ndocs fehlt | Nicht abgeschlossen, eine Erfassung ohne Lebenderkennung, ein negativer Abgleich oder die Intelligence konnte nicht berechnet werden. Lesen Sie erneut. Siehe Intelligence |
Journey-token / link fehlen bei GET | Sie werden nur beim Create zurückgegeben |
PROCESS_STATE_FAILED mit data: {} | Der Prozess endete ohne Ergebnis. Siehe Prozess-Lebenszyklus |
| Ein ausstehender Prozess schreitet nie voran | Nichts aktualisiert ihn außer einem GET. Fragen Sie ihn per Polling ab |