معالجة الأخطاء في Cloud Storage لـ C++

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

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

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

معالجة رسائل الخطأ

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

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

الاسم السبب
kErrorNone لم يحدث أي خطأ.
kErrorUnknown حدث خطأ غير معروف.
kErrorObjectNotFound لا يتوفّر أي عنصر في المرجع المحدّد.
kErrorBucketNotFound لم يتم إعداد حزمة لـ Cloud Storage.
kErrorProjectNotFound لم يتم إعداد أي مشروع لـ Cloud Storage.
kErrorQuotaExceeded تم تجاوز الحصة في حزمة Cloud Storage. إذا كنت مشتركًا في خطة أسعار Spark، ننصحك بالترقية إلى خطة أسعار Blaze المستندة إلى الدفع عند الاستخدام. إذا كنت مشتركًا في خطة أسعار Blaze، يُرجى التواصل مع فريق دعم Firebase.

ملاحظة مهمة: اعتبارًا من 1 تشرين الأول (أكتوبر) 2025، ستكون خطة أسعار Blaze مطلوبة لاستخدام Cloud Storage، حتى الحِزم التلقائية.
kErrorUnauthenticated لم يتم مصادقة المستخدم. يُرجى المصادقة وإعادة المحاولة.
kErrorUnauthorized المستخدم غير مفوَّض بتنفيذ الإجراء المطلوب. تحقَّق من قواعدك للتأكّد من صحتها.
kErrorRetryLimitExceeded تم تجاوز الحد الأقصى للوقت المسموح به لتنفيذ عملية (تحميل أو تنزيل أو حذف أو غير ذلك). يُرجى محاولة التحميل مرة أخرى.
kErrorNonMatchingChecksum لا يتطابق الملف على جهاز العميل مع القيمة المحسوبة للملف الذي تلقّاه الخادم. يُرجى محاولة التحميل مرة أخرى.
kErrorCanceled ألغى المستخدِم العملية.
kErrorDownloadSizeExceeded حجم الملف الذي تم تنزيله يتجاوز مقدار الذاكرة المخصّصة للتنزيل. يمكنك زيادة الحد الأقصى للذاكرة وإعادة محاولة التنزيل.