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

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

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