أحيانًا، عند إنشاء تطبيق، لا تسير الأمور كما هو مخطط لها ويحدث خطأ.
عند الشك، يمكنك التحقّق من معالج الأخطاء (أو الدالة 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. إذا كنت مشتركًا في خطة Spark الأساسية، ننصحك بالترقية إلى خطة Blaze المَرِنة للدفع حسب الاستخدام . إذا كنت مشتركًا في خطة Blaze المَرِنة، يُرجى التواصل مع فريق دعم 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://حزمة/عنصر أو https://firebasestorage.googleapis.com/v0/b/حزمة/o/عنصر?رمز مميز=<رمز مميز> |
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 |
لا يتطابق الملف على العميل مع حجم الملف الذي تلقّاه الخادم. يُرجى محاولة التحميل مرة أخرى. |