Flutter पर Cloud Storage के लिए गड़बड़ियां मैनेज करना

कभी-कभी ऐप्लिकेशन बनाते समय, चीज़ें ठीक से नहीं होतीं और कोई गड़बड़ी हो जाती है!

अगर आपको कोई संदेह है, तो फ़ंक्शन से मिलने वाले अपवाद को पकड़ें और देखें कि गड़बड़ी के मैसेज में क्या कहा गया है.

final storageRef = FirebaseStorage.instance.ref().child("files/uid");
try {
  final listResult = await storageRef.listAll();
} on FirebaseException catch (e) {
  // Caught an exception from Firebase.
  print("Failed with error '${e.code}': ${e.message}");
}

ध्यान दें: डिफ़ॉल्ट रूप से, Cloud Storage for Firebase बकेट के डेटा या फ़ाइलों पर कोई कार्रवाई करने के लिए, Firebase Authentication को अनुमति की ज़रूरत होती है. कुछ खास मामलों में पुष्टि किए बिना ऐक्सेस देने की अनुमति देने के लिए, Firebase Security Rules को Cloud Storage में बदला जा सकता है. हालांकि, ज़्यादातर मामलों में, हमारा सुझाव है कि आप ऐक्सेस पर पाबंदी लगाएं और सुरक्षा से जुड़े सख्त नियम सेट अप करें. ऐसा खास तौर पर, प्रोडक्शन ऐप्लिकेशन के लिए करें. ध्यान दें कि अगर Google App Engine का इस्तेमाल किया जाता है और आपके पास *.appspot.com नाम वाले फ़ॉर्मैट वाली डिफ़ॉल्ट Cloud Storage बकेट है, तो आपको यह देखना पड़ सकता है कि आपके सुरक्षा नियम, App Engine फ़ाइलों के ऐक्सेस पर कैसे असर डालते हैं.

गड़बड़ी के मैसेज मैनेज करना

गड़बड़ियां होने की कई वजहें हो सकती हैं. जैसे, फ़ाइल मौजूद न होना, उपयोगकर्ता के पास फ़ाइल को ऐक्सेस करने की अनुमति न होना या उपयोगकर्ता ने फ़ाइल अपलोड करने की प्रोसेस रद्द कर दी हो.

समस्या का सही तरीके से पता लगाने और गड़बड़ी को ठीक करने के लिए, यहां उन सभी गड़बड़ियों की पूरी सूची दी गई है जो हमारे क्लाइंट से दिखेंगी. साथ ही, यह भी बताया गया है कि ये गड़बड़ियां कैसे हुईं.

कोड	ब्यौरा
storage/unknown	कोई अनजानी गड़बड़ी हुई.
storage/object-not-found	जिस रेफ़रंस का इस्तेमाल किया जा रहा है वहां कोई ऑब्जेक्ट मौजूद नहीं है.
storage/bucket-not-found	Cloud Storage के लिए कोई बकेट कॉन्फ़िगर नहीं किया गया है
storage/project-not-found	Cloud Storage के लिए कोई प्रोजेक्ट कॉन्फ़िगर नहीं किया गया है
storage/quota-exceeded	आपकी Cloud Storage बकेट का कोटा पूरा हो गया है. अगर आपने Spark की कीमत का प्लान लिया है, तो इस्तेमाल के हिसाब से पैसे चुकाने वाले ब्लेज़ प्लान पर अपग्रेड करें. अगर आपने पहले ही Blaze प्लान की सदस्यता ली हुई है, तो Firebase की सहायता टीम से संपर्क करें. अहम जानकारी: 1 अक्टूबर, 2025 से, Cloud Storage का इस्तेमाल करने के लिए, Blaze प्लान की सदस्यता लेना ज़रूरी होगा. इसमें डिफ़ॉल्ट बकेट भी शामिल हैं.
storage/unauthenticated	उपयोगकर्ता की पुष्टि नहीं हुई है. कृपया पुष्टि करें और फिर से कोशिश करें.
storage/unauthorized	उपयोगकर्ता मनचाही कार्रवाई करने के लिए अधिकृत नहीं है. अपने सुरक्षा नियमों की जांच करके पक्का करें कि वे सही हैं.
storage/retry-limit-exceeded	किसी कार्रवाई (अपलोड, डाउनलोड, मिटाना वगैरह) के लिए तय की गई समयसीमा खत्म हो गई है. फिर से अपलोड करने की कोशिश करें.
storage/invalid-checksum	क्लाइंट पर मौजूद फ़ाइल, सर्वर से मिली फ़ाइल के चेकसम से मेल नहीं खाती. फिर से अपलोड करें.
storage/canceled	उपयोगकर्ता ने कार्रवाई रद्द कर दी है.
storage/invalid-event-name	इवेंट का नाम अमान्य है. [running, progress, pause] में से एक होना चाहिए
storage/invalid-url	refFromURL() के लिए दिया गया यूआरएल अमान्य है. इसका फ़ॉर्मैट ऐसा होना चाहिए: gs://bucket/object या https://firebasestorage.googleapis.com/v0/b/bucket/o/object?token=<TOKEN>
storage/invalid-argument	put() फ़ंक्शन में दिया गया आर्ग्युमेंट, File, Blob या UInt8 ऐरे होना चाहिए. putString() फ़ंक्शन में इस्तेमाल किया गया आर्ग्युमेंट, रॉ, Base64 या Base64URL स्ट्रिंग होना चाहिए.
storage/no-default-bucket	आपके कॉन्फ़िगरेशन की storageBucket प्रॉपर्टी में कोई बकेट सेट नहीं की गई है.
storage/cannot-slice-blob	आम तौर पर, यह तब होता है, जब लोकल फ़ाइल में बदलाव किया गया हो (जैसे, मिटाना, फिर से सेव करना वगैरह). फ़ाइल में कोई बदलाव न होने की पुष्टि करने के बाद, उसे फिर से अपलोड करने की कोशिश करें.
storage/server-file-wrong-size	क्लाइंट पर मौजूद फ़ाइल का साइज़, सर्वर पर मौजूद फ़ाइल के साइज़ से मेल नहीं खाता. फिर से अपलोड करें.