---
title: Fehlerbehebung
description: Startfehler, Fehlerantworten und unerwartete Ergebnisse in Human Plugin, jeweils mit Ursache und Lösung.
canonical: https://developer.unico.io/de/human-plugin/additional-resources/troubleshooting
locale: de
generated_by: markdown-export
---

# 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](/de/human-plugin/self-hosting/configuration) 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](/de/human-plugin/self-hosting/configuration#database-connection) 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](/de/human-plugin/api-reference/create-process) |
| `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](/de/human-plugin/api-reference/create-process#flow-refusals) |
| `502 UPSTREAM_UNAVAILABLE` bei jedem Create | Ausgehendes HTTPS blockiert | Prüfen Sie den [Egress](/de/human-plugin/self-hosting/networking-and-security) und den Access Key. Zu Wiederholungen siehe [Fehler und Wiederholungen](/de/human-plugin/api-reference/errors-and-retries) |
| `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](/de/human-plugin/get-started/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](/de/human-plugin/api-reference/process-lifecycle) |
| Ein ausstehender Prozess schreitet nie voran | Nichts aktualisiert ihn außer einem `GET`. Fragen Sie ihn per Polling ab |