في بعض الأحيان عند إنشاء تطبيق ما، لا تسير الأمور كما هو مخطط لها ويحدث خطأ!
إذا كانت لديك شكوك، تحقَّق من معالِج الأخطاء (أو دالة catch()
للإشارة إلى التعهدات)،
واطّلِع على محتوى رسالة الخطأ.
إذا راجعت رسالة الخطأ وكانت لديك قواعد أمان Cloud Storage تسمح باتخاذ الإجراء، ولكنّك لا تزال تواجه صعوبات في حلّ الخطأ، انتقِل إلى صفحة الدعم وأخبِرنا كيف يمكننا مساعدتك.
التعامل مع رسائل الخطأ
هناك عدد من الأسباب التي قد تؤدّي إلى حدوث أخطاء، منها عدم توفّر الملف أو عدم امتلاك المستخدم إذن للوصول إلى الملف المطلوب أو إلغاء المستخدم لتحميل الملف.
لتشخيص المشكلة والتعامل مع الخطأ بشكل صحيح، إليك قائمة كاملة بجميع الأخطاء التي سيقدمها البرنامج وكيفية حدوثها.
الرمز | السبب |
---|---|
storage/unknown |
حدث خطأ غير معروف. |
storage/object-not-found |
لا يوجد عنصر في المرجع المطلوب. |
storage/bucket-not-found |
لم يتم ضبط أي حزمة لخدمة Cloud Storage. |
storage/project-not-found |
لم يتم ضبط أي مشروع لاستخدامه في Cloud Storage. |
storage/quota-exceeded |
تم تجاوز الحصة المسموح بها في حزمتك على Cloud Storage. إذا كنت مشتركًا في الفئة بدون تكلفة، عليك الترقية إلى خطة مدفوعة. وإذا كنت مشتركًا في خطة مدفوعة، يُرجى التواصل مع فريق دعم Firebase. |
storage/unauthenticated |
لم تتم مصادقة المستخدم، يُرجى المصادقة وإعادة المحاولة. |
storage/unauthorized |
المستخدم غير مصرح له بتنفيذ الإجراء المطلوب. يُرجى مراجعة قواعد الأمان للتأكد من صحتها. |
storage/retry-limit-exceeded |
الحد الأقصى للمدة الزمنية للعملية (تحميل أو تنزيل أو حذف أو غير ذلك) تم الاستبعاد. يُرجى محاولة تحميل الفيديو مرة أخرى. |
storage/invalid-checksum |
لا يتطابق الملف الموجود على العميل مع المجموع الاختباري للملف الذي تم استلامه من خلال الخادم. يُرجى محاولة تحميل الفيديو مرة أخرى. |
storage/canceled |
ألغى المستخدم العملية. |
storage/invalid-event-name |
تم تقديم اسم حدث غير صالح. يجب أن تكون القيمة واحدة مما يلي:
[`running` أو `progress` أو `pause` ]. |
storage/invalid-url |
تم تقديم عنوان URL غير صالح إلى "refFromURL() ". يجب أن يكون بالصيغة:
gs://bucket/object أو https://firebasestorage.googleapis.com/v0/b/bucket/o/object?token=<TOKEN> |
storage/invalid-argument |
يجب أن تكون الوسيطة التي تم تمريرها إلى put() مصفوفة "File" أو "Blob" أو
"UInt8". يجب أن تكون الوسيطة التي تم تمريرها إلى putString()
سلسلة أولية أو "Base64" أو "Base64URL". |
storage/no-default-bucket |
لم يتم ضبط أي حزمة في السمة storageBucket ضمن الإعدادات. |
storage/cannot-slice-blob |
يحدث ذلك عادةً عند تغيير الملف على الجهاز (سواء تم حذفه أو حفظه مرة أخرى وما إلى ذلك). حاوِل تحميل الملف مجددًا بعد التأكّد من أنّ الملف لم يتغيّر. |
storage/server-file-wrong-size |
الملف على العميل لا يتطابق مع حجم الملف الذي استلمه الخادم. يُرجى محاولة تحميل الفيديو مرة أخرى. |