في بعض الأحيان عند إنشاء تطبيق ما، لا تسير الأمور كما هو مخطط لها حدث خطأ!
إذا كانت لديك شكوك، تحقَّق من معالِج الأخطاء (أو دالة 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() "ملف" أو "Blob" أو
مصفوفة "UInt8". يجب أن تكون الوسيطة التي تم تمريرها إلى putString()
سلسلة أولية أو "Base64" أو "Base64URL". |
storage/no-default-bucket |
لم يتم ضبط أي حزمة في إعداداتك
الموقع: storageBucket. |
storage/cannot-slice-blob |
يحدث ذلك عادةً عند تغيير الملف المحلي (يتم حذفه أو حفظه مرة أخرى وما إلى ذلك). حاوِل التحميل مرة أخرى بعد التأكّد من عدم إزالة الملف. بتغييره. |
storage/server-file-wrong-size |
الملف الموجود على العميل لا يتطابق مع حجم الملف الذي استلمه العميل الخادم. يُرجى محاولة تحميل الفيديو مرة أخرى. |