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

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

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