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

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

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

ملاحظة: تتطلّب حزمة Cloud Storage for Firebase تلقائيًا من Firebase Authentication تنفيذ أي إجراء على بيانات الحزمة أو ملفاتها. يمكنك تغيير Firebase Security Rules إلى Cloud Storage لالسماح بالوصول غير المعتمَد في حالات معيّنة. ومع ذلك، في معظم الحالات، ننصحك بشدة بحظر الوصول وإعداد قواعد أمان صارمة (خاصةً للتطبيقات العلنية). يُرجى العِلم أنّه في حال استخدام Google App Engine وامتلاك حزمة Cloud Storage تلقائية بتنسيق اسم *.appspot.com، قد تحتاج إلى مراعاة كيفية تأثير قواعد الأمان في الوصول إلى ملفات App Engine.

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

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

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

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

الاسم	السبب
FIRStorageErrorCodeUnknown	حدث خطأ غير معروف.
FIRStorageErrorCodeObjectNotFound	لا يتوفّر أي عنصر في المرجع المحدّد.
FIRStorageErrorCodeBucketNotFound	لم يتم إعداد حزمة لـ Cloud Storage.
FIRStorageErrorCodeProjectNotFound	لم يتم إعداد أي مشروع لـ Cloud Storage.
FIRStorageErrorCodeQuotaExceeded	تم تجاوز الحصة في حزمة Cloud Storage. إذا كنت مشتركًا في خطة أسعار Spark، ننصحك بالترقية إلى خطة أسعار Blaze المستندة إلى الدفع عند الاستخدام. إذا كنت مشتركًا في خطة أسعار Blaze، يُرجى التواصل مع فريق دعم Firebase. ملاحظة مهمة: اعتبارًا من 1 تشرين الأول (أكتوبر) 2025، ستكون خطة أسعار Blaze مطلوبة لاستخدام Cloud Storage، حتى الحِزم التلقائية.
FIRStorageErrorCodeUnauthenticated	لم يتم مصادقة المستخدم. يُرجى المصادقة وإعادة المحاولة.
FIRStorageErrorCodeUnauthorized	المستخدم غير مفوَّض بتنفيذ الإجراء المطلوب. تحقَّق من قواعدك للتأكّد من صحتها.
FIRStorageErrorCodeRetryLimitExceeded	تم تجاوز الحد الأقصى المسموح به للمدة الزمنية للعملية (تحميل أو تنزيل أو حذف أو غير ذلك). يُرجى محاولة تحميل الفيديو مرة أخرى.
FIRStorageErrorCodeNonMatchingChecksum	لا يتطابق الملف على جهاز العميل مع القيمة المحسوبة للملف الذي تلقّاه الخادم. يُرجى محاولة التحميل مرة أخرى.
FIRStorageErrorCodeCanceled	ألغى المستخدِم العملية.
FIRStorageErrorCodeDownloadSizeExceeded	حجم الملف الذي تم تنزيله يتجاوز مقدار الذاكرة المخصّصة للتنزيل. عليك زيادة الحد الأقصى للذاكرة ومحاولة التنزيل مرة أخرى.