معالجة الأخطاء في Cloud Storage على الويب

في بعض الأحيان، عند إنشاء تطبيق، لا تسير الأمور كما هو مخطط لها ويحدث خطأ.

عند الشك، يمكنك مراجعة معالج الأخطاء (أو دالة 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=&ltTOKEN>
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 الملف على العميل لا يتطابق مع حجم الملف الذي تلقاه الخادم. يُرجى محاولة تحميل الفيديو مرة أخرى.