---
title: استكشاف الأخطاء وإصلاحها
description: إخفاقات بدء التشغيل واستجابات الأخطاء والنتائج غير المتوقعة في Human Plugin، مع السبب والحل لكل منها.
canonical: https://developer.unico.io/ar/human-plugin/additional-resources/troubleshooting
locale: ar
generated_by: markdown-export
---

# استكشاف الأخطاء وإصلاحها

العَرَض والسبب وما يجب فعله.

## الحاوية لا تبدأ

| رسالة السجل (ملخص) | السبب | الحل |
| --- | --- | --- |
| Reading config | `POSTGRES_ADDRESS_HOST` أو `POSTGRES_PASSWORD` أو `HUMAN_API_ACCESS_KEY` مفقود أو فارغ | اضبطه |
| `POSTGRES_PASSWORD must not contain…` | مسافات بيضاء أو علامات اقتباس أو شرطة مائلة عكسية أو محارف تحكم | استخدم كلمة مرور أخرى |
| أي متغير آخر مذكور في الخطأ | جرى ضبط متغير خارج [الإعدادات المدعومة](/ar/human-plugin/self-hosting/configuration) | أزله |
| 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 خاطئ، أو لا يستطيع الدور إنشاء الجداول | راجع [اتصال قاعدة البيانات](/ar/human-plugin/self-hosting/configuration#database-connection) وصلاحيات الدور |

## الطلبات

| العَرَض | السبب | الحل |
| --- | --- | --- |
| `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`)، أو قيمة غير نصية في أحدها | استخدم أسماء الحقول الدقيقة من [إنشاء عملية](/ar/human-plugin/api-reference/create-process) |
| `400 INVALID_CLIENT_ID` (أو حقل آخر) | تجاوز حد البايتات، أو محارف تحكم، أو مسافات في الأطراف | قصّ المسافات واختصر القيمة |
| `400 REQUEST_TOO_LARGE` | الجسم أكبر من 2 MiB | قلّل حجم الصورة |
| `409 CORRELATION_ID_ALREADY_USED` | عملية أخرى تملك `correlationId` نفسه، بما فيها العمليات الفاشلة | أرسل `correlationId` جديدًا وفريدًا |
| `422 ATTRIBUTE_TYPE_NOT_SUPPORTED` | الرمز ليس في الكتالوج، أو حالة الأحرف خاطئة | استخدم رمزًا دقيقًا من الكتالوج |
| `4xx` مع `message` غير مألوفة | رفض التدفق الطلب: التدفق أو الصورة أو أحد حقول التدفق | راجع [حالات الرفض](/ar/human-plugin/api-reference/create-process#flow-refusals) |
| `502 UPSTREAM_UNAVAILABLE` في كل إنشاء | حركة HTTPS الصادرة محظورة | تحقق من [حركة الخروج](/ar/human-plugin/self-hosting/networking-and-security) ومفتاح الوصول. لإعادة المحاولة، راجع [الأخطاء وإعادة المحاولة](/ar/human-plugin/api-reference/errors-and-retries) |
| `503 DATABASE_UNAVAILABLE` | PostgreSQL غير قابل للوصول | تحقق من قاعدة البيانات. كما يفشل فحص الجاهزية |
| `404 PROCESS_NOT_FOUND` لعملية معروفة | تثبيت أو قاعدة بيانات خاطئة، أو معرّف مشوَّه | تأكد من المعرّف ومن نسخة Human Plugin التي تستدعيها |

## النتائج

| العَرَض | السبب |
| --- | --- |
| `PROCESS_STATE_FINISHED` لكن الشخص لم يتطابق | الحالة «منتهية» تشمل النتيجة السلبية. اقرأ `data` |
| `data.ndocs` غير موجود | العملية لم تنتهِ، أو التقاط غير حي، أو عدم تطابق، أو تعذّر حساب المعلومات. اقرأ مرة أخرى. راجع [المعلومات](/ar/human-plugin/get-started/intelligence) |
| غياب `token` / `link` الخاصين بالرحلة في `GET` | لا يُعادان إلا عند الإنشاء |
| `PROCESS_STATE_FAILED` مع `data: {}` | انتهت العملية دون نتيجة. راجع [دورة حياة العملية](/ar/human-plugin/api-reference/process-lifecycle) |
| عملية معلّقة لا تتقدم أبدًا | لا شيء يحدّثها سوى `GET`. استعلم عنها دوريًا |