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