أحيانًا، عند إنشاء تطبيق، لا تسير الأمور كما هو مخطّط ويحدث خطأ.
في حال الشك، يُرجى التحقّق من معالج الأخطاء (أو الدالة catch() للوعود)، والاطّلاع على رسالة الخطأ.
إذا تحقّقت من رسالة الخطأ وكانت لديك Cloud Storage Security Rules تسمح بإجراءك، ولكنك لا تزال تواجه صعوبة في حلّ الخطأ، يُرجى الانتقال إلى صفحتنا للدعم وإعلامنا كيف يمكننا مساعدتك.
التعامل مع رسائل الخطأ
هناك عدد من الأسباب التي قد تؤدي إلى حدوث أخطاء، بما في ذلك عدم توفّر الملف أو عدم حصول المستخدم على إذن للوصول إلى الملف المطلوب أو إلغاء المستخدم لعملية تحميل الملف.
لتشخيص المشكلة بشكل صحيح والتعامل مع الخطأ، إليك قائمة كاملة بجميع الأخطاء التي سيُبلغ عنها العميل وكيفية حدوثها.
| الرمز | السبب |
|---|---|
storage/unknown |
حدث خطأ غير معروف. |
storage/object-not-found |
ما مِن عنصر متوفّر في المرجع المحدّد. |
storage/bucket-not-found |
لم يتم إعداد أي سِجلّ في Cloud Storage |
storage/project-not-found |
لم يتم إعداد أي مشروع في Cloud Storage |
storage/quota-exceeded |
تم تجاوز الحصة المخصّصة لسِجلّك. يتطلّب Cloud Storage for Firebase خطة Blaze المَرِنة للدفع حسب الاستخدام. إذا ظهر لك هذا الخطأ في مشروع ضمن خطة Spark الأساسية، عليك الترقية إلى خطة Blaze المَرِنة لاستعادة إمكانية الوصول. لمزيد من التفاصيل، يمكنك مراجعة الأسئلة الشائعة. |
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` Array. يجب أن تكون الوسيطة التي تم تمريرها إلى putString() هي
سلسلة أولية أو `Base64` أو `Base64URL`. |
storage/no-default-bucket |
لم يتم ضبط أي سِجلّ في السِمة
storageBucket في إعدادات Firebase. |
storage/cannot-slice-blob |
يحدث هذا الخطأ عادةً عندما يتم تغيير الملف المحلي (حذفه أو حفظه مرة أخرى أو غير ذلك ). يُرجى محاولة التحميل مرة أخرى بعد التأكّد من عدم تغيير الملف. |
storage/server-file-wrong-size |
لا يتطابق الملف على جهاز العميل مع حجم الملف الذي تلقّاه الخادم. يُرجى محاولة التحميل مرة أخرى. |