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 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 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 |
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 |
502 UPSTREAM_UNAVAILABLE pada setiap pembuatan | HTTPS keluar diblokir | Periksa egress dan access key. Untuk percobaan ulang, lihat Error dan percobaan ulang |
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 |
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 |
| Proses tertunda tidak pernah maju | Tidak ada yang memperbaruinya kecuali GET. Lakukan polling |