معالجة الأخطاء في Cloud Storage على أنظمة Apple الأساسية

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

في حال الشك، يُرجى التحقّق من الخطأ الذي تم عرضه والاطّلاع على رسالة الخطأ.

إذا تحقّقت من رسالة الخطأ وكانت لديك Cloud Storage Security Rules تسمح بإجراءك، ولكن لا تزال تواجه صعوبة في إصلاح الخطأ، يُرجى الانتقال إلى صفحة الدعم وإعلامنا كيف يمكننا مساعدتك.

التعامل مع رسائل الخطأ

هناك عدد من الأسباب التي قد تؤدي إلى حدوث الأخطاء، بما في ذلك عدم توفّر الملف أو عدم حصول المستخدِم على إذن للوصول إلى الملف المطلوب أو إلغاء المستخدِم لعملية تحميل الملف.

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

الاسم السبب
FIRStorageErrorCodeUnknown حدث خطأ غير معروف.
FIRStorageErrorCodeObjectNotFound لا يتوفّر أي عنصر في المرجع المحدّد.
FIRStorageErrorCodeBucketNotFound لم يتم إعداد أي نطاق في Cloud Storage.
FIRStorageErrorCodeProjectNotFound لم يتم إعداد أي مشروع في Cloud Storage.
FIRStorageErrorCodeQuotaExceeded تم تجاوز الحصة المخصّصة لنطاق Cloud Storage. إذا كنت مشتركًا في خطة Spark الأساسية، ننصحك بالترقية إلى خطة Blaze المَرِنة للدفع حسب الاستخدام . إذا كنت مشتركًا في خطة Blaze المَرِنة، يُرجى التواصل مع فريق دعم Firebase.

ملاحظة مهمة: اعتبارًا من 03 فبراير 2026، ستكون خطة Blaze المَرِنة مطلوبة لاستخدام Cloud Storage، حتى الحِزَم التلقائية.
FIRStorageErrorCodeUnauthenticated لم تتم مصادقة المستخدِم. يُرجى إجراء المصادقة والمحاولة مرة أخرى.
FIRStorageErrorCodeUnauthorized المستخدِم غير مخوَّل بتنفيذ الإجراء المطلوب. يُرجى التحقّق من القواعد للتأكّد من صحتها.
FIRStorageErrorCodeRetryLimitExceeded تم تجاوز الحد الأقصى للوقت المسموح به لإجراء عملية (تحميل أو تنزيل أو حذف أو غير ذلك). يُرجى محاولة تحميل الفيديو مرة أخرى.
FIRStorageErrorCodeNonMatchingChecksum لا يتطابق الملف على العميل مع مجموع التحقّق من الملف الذي تلقّاه الخادم. يُرجى محاولة تحميل الفيديو مرة أخرى.
FIRStorageErrorCodeCanceled ألغى المستخدِم العملية.
FIRStorageErrorCodeDownloadSizeExceeded يتجاوز حجم الملف الذي تم تنزيله مقدار الذاكرة المخصّصة للتنزيل. يُرجى زيادة الحد الأقصى للذاكرة ومحاولة التنزيل مرة أخرى.