---
title: Pemecahan masalah
description: Kegagalan startup, respons error, dan hasil yang tidak terduga di Human Plugin, beserta penyebab dan solusi masing-masing.
canonical: https://developer.unico.io/id/human-plugin/additional-resources/troubleshooting
locale: id
generated_by: markdown-export
---

# Pemecahan masalah

Gejala, penyebab, dan apa yang harus dilakukan.

## Container tidak mau start

| Pesan log (ringkasan) | Penyebab | Solusi |
| --- | --- | --- |
| Reading config | `POSTGRES_ADDRESS_HOST`, `POSTGRES_PASSWORD`, atau `HUMAN_API_ACCESS_KEY` tidak ada atau kosong | Atur variabelnya |
| `POSTGRES_PASSWORD must not contain…` | Berisi spasi, tanda kutip, backslash, atau karakter kontrol | Gunakan kata sandi lain |
| Variabel lain yang disebut dalam error | Variabel di luar [konfigurasi yang didukung](/id/human-plugin/self-hosting/configuration) diatur | Hapus variabel tersebut |
| Downloading attribute catalog | Egress ke `human-token-assets.unico.app` diblokir, atau tidak ada jawaban dalam 10 detik | Izinkan HTTPS keluar ke host tersebut |
| `database "…" does not exist` | Database yang disebut di `POSTGRES_DATABASE`, secara default `human_plugin`, belum dibuat | Buat database tersebut, atau atur `POSTGRES_DATABASE` ke database yang Anda buat |
| Connecting to or preparing the database | PostgreSQL tidak dapat dijangkau, kredensial atau mode SSL salah, atau role tidak dapat membuat tabel | Periksa [koneksi database](/id/human-plugin/self-hosting/configuration#database-connection) dan izin role |

## Permintaan

| Gejala | Penyebab | Solusi |
| --- | --- | --- |
| `401` dengan `{"message":"","details":[]}` | Unico menolak access key: tidak ada, salah, atau sudah tidak berlaku | Periksa `HUMAN_API_ACCESS_KEY` dan restart Human Plugin. Jika key sudah benar, minta Unico memastikan key tersebut aktif |
| `400 MISSING_CREDENTIAL_TYPE` | `credential` tidak ada, atau berupa objek dengan string kosong | Kirim dokumen, atau `null` / `{}` |
| `400 INVALID_REQUEST` dengan body yang tampak valid | Field yang dicadangkan Human Plugin, ejaan lain dari `clientId`, `correlationId`, atau `credential` (seperti `client_id`), atau nilai bukan string di salah satunya | Gunakan nama field yang persis dari [Membuat proses](/id/human-plugin/api-reference/create-process) |
| `400 INVALID_CLIENT_ID` (atau field lain) | Melebihi batas byte, berisi karakter kontrol, atau ada spasi di sekelilingnya | Pangkas dan perpendek |
| `400 REQUEST_TOO_LARGE` | Body lebih dari 2 MiB | Kecilkan ukuran gambar |
| `409 CORRELATION_ID_ALREADY_USED` | Proses lain sudah memiliki `correlationId` tersebut, termasuk proses yang gagal | Kirim `correlationId` baru yang unik |
| `422 ATTRIBUTE_TYPE_NOT_SUPPORTED` | Kode tidak ada di katalog, atau huruf besar/kecil salah | Gunakan kode persis dari katalog |
| `4xx` dengan `message` yang tidak dikenal | Flow menolak permintaan: flow, gambar, atau field flow | Lihat [Penolakan](/id/human-plugin/api-reference/create-process#flow-refusals) |
| `502 UPSTREAM_UNAVAILABLE` pada setiap pembuatan | HTTPS keluar diblokir | Periksa [egress](/id/human-plugin/self-hosting/networking-and-security) dan access key. Untuk percobaan ulang, lihat [Error dan percobaan ulang](/id/human-plugin/api-reference/errors-and-retries) |
| `503 DATABASE_UNAVAILABLE` | PostgreSQL tidak dapat dijangkau | Periksa database. Readiness juga gagal |
| `404 PROCESS_NOT_FOUND` untuk proses yang dikenal | Instalasi atau database salah, atau id tidak valid | Pastikan id dan Human Plugin mana yang Anda panggil |

## Hasil

| Gejala | Penyebab |
| --- | --- |
| `PROCESS_STATE_FINISHED` tetapi orang tersebut tidak cocok | Status selesai juga mencakup hasil negatif. Baca `data` |
| `data.ndocs` tidak ada | Belum selesai, pengambilan non-live, kecocokan negatif, atau intelligence tidak dapat dihitung. Baca ulang. Lihat [Intelligence](/id/human-plugin/get-started/intelligence) |
| `token` / `link` Journey tidak ada pada `GET` | Keduanya hanya dikembalikan saat pembuatan |
| `PROCESS_STATE_FAILED` dengan `data: {}` | Proses berakhir tanpa hasil. Lihat [Siklus hidup proses](/id/human-plugin/api-reference/process-lifecycle) |
| Proses tertunda tidak pernah maju | Tidak ada yang memperbaruinya kecuali `GET`. Lakukan polling |