استكشاف الأخطاء وإصلاحها
العَرَض والسبب وما يجب فعله.
الحاوية لا تبدأ
| رسالة السجل (ملخص) | السبب | الحل |
|---|---|---|
| Reading config | POSTGRES_ADDRESS_HOST أو POSTGRES_PASSWORD أو HUMAN_API_ACCESS_KEY مفقود أو فارغ | اضبطه |
POSTGRES_PASSWORD must not contain… | مسافات بيضاء أو علامات اقتباس أو شرطة مائلة عكسية أو محارف تحكم | استخدم كلمة مرور أخرى |
| أي متغير آخر مذكور في الخطأ | جرى ضبط متغير خارج الإعدادات المدعومة | أزله |
| Downloading attribute catalog | حركة الخروج إلى human-token-assets.unico.app محظورة، أو لا رد خلال 10 ثوانٍ | اسمح بحركة HTTPS الصادرة إليه |
database "…" does not exist | لم تُنشأ قاعدة البيانات المذكورة في POSTGRES_DATABASE، وهي human_plugin افتراضيًا | أنشئ قاعدة البيانات، أو اضبط POSTGRES_DATABASE على القاعدة التي أنشأتها |
| Connecting to or preparing the database | PostgreSQL غير قابل للوصول، أو بيانات اعتماد أو وضع SSL خاطئ، أو لا يستطيع الدور إنشاء الجداول | راجع اتصال قاعدة البيانات وصلاحيات الدور |
الطلبات
| العَرَض | السبب | الحل |
|---|---|---|
401 مع {"message":"","details":[]} | رفضت Unico مفتاح الوصول: مفقود أو خاطئ أو لم يعد صالحًا | تحقق من HUMAN_API_ACCESS_KEY وأعد تشغيل Human Plugin. إذا كان المفتاح صحيحًا، اطلب من Unico تأكيد تف عيله |
400 MISSING_CREDENTIAL_TYPE | credential مفقود، أو كائن بقيم نصية فارغة | أرسل وثيقة، أو null / {} |
400 INVALID_REQUEST مع جسم يبدو صالحًا | حقل يحجزه Human Plugin، أو تهجئة أخرى لـ clientId أو correlationId أو credential (مثل client_id)، أو قيمة غير نصية في أحدها | استخدم أسماء الحقول الدقيقة من إنشاء عملية |
400 INVALID_CLIENT_ID (أو حقل آخر) | تجاوز حد البايتات، أو محارف تحكم، أو مسافات في الأطراف | قصّ المسافات واختصر القيمة |
400 REQUEST_TOO_LARGE | الجسم أكبر من 2 MiB | قلّل حجم الصورة |
409 CORRELATION_ID_ALREADY_USED | عملية أخرى تملك correlationId نفسه، بما فيها العمليات الفاشلة | أرسل correlationId جديدًا وفريدًا |
422 ATTRIBUTE_TYPE_NOT_SUPPORTED | الرمز ليس في الكتالوج، أو حالة الأحرف خاطئة | استخدم رمزًا دقيقًا من الكتالوج |
4xx مع message غير مألوفة | رفض التدفق الطلب: التدفق أو الصورة أو أحد حقول التدفق | راجع حالات الرفض |
502 UPSTREAM_UNAVAILABLE في كل إنشاء | حركة HTTPS الصادرة محظورة | تحقق من حركة الخروج ومفتاح الوصول. لإعادة المحاولة، راجع الأخطاء وإعادة المحاولة |
503 DATABASE_UNAVAILABLE | PostgreSQL غير قابل للوصول | تحقق من قاعدة البيانات. كما يفشل فحص الجاهزية |
404 PROCESS_NOT_FOUND لعملية معروفة | تثبيت أو قاعدة بيانات خاطئة، أو معرّف مشوَّه | تأكد من المعرّف ومن نسخة Human Plugin التي تستدعيها |
النتائج
| العَرَض | السبب |
|---|---|
PROCESS_STATE_FINISHED لكن الشخص لم يتطابق | الحالة «منتهية» تشمل النتيجة السلبية. اقرأ data |
data.ndocs غير موجود | العملية لم تنتهِ، أو التقاط غير حي، أو عدم تطابق، أو تعذّر حساب المعلومات. اقرأ مرة أخرى. راجع المعلومات |
غياب token / link الخاصين بالرحلة في GET | لا يُعادان إلا عند الإنشاء |
PROCESS_STATE_FAILED مع data: {} | انتهت العملية دون نتيجة. راجع دورة حياة العملية |
| عملية معلّقة لا تتقدم أبدًا | لا شيء يحدّثها سوى GET. استعلم عنها دوريًا |