จัดการข้อผิดพลาดสำหรับ Cloud Storage ใน Flutter

บางครั้งเมื่อคุณสร้างแอป ทุกอย่างอาจไม่เป็นไปตามแผนที่วางไว้และเกิดข้อผิดพลาดขึ้น

หากมีข้อสงสัย ให้จับข้อยกเว้นที่ฟังก์ชันแสดงและดูว่าข้อความแสดงข้อผิดพลาดบอกอะไร

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}");
}

จัดการข้อความแสดงข้อผิดพลาด

ข้อผิดพลาดอาจเกิดขึ้นได้จากหลายสาเหตุ เช่น ไฟล์ไม่อยู่ ผู้ใช้ไม่มีสิทธิ์เข้าถึงไฟล์ที่ต้องการ หรือผู้ใช้ยกเลิกการอัปโหลดไฟล์

ต่อไปนี้เป็นรายการข้อผิดพลาดทั้งหมดที่ลูกค้าจะแจ้งและสาเหตุที่ทำให้เกิดข้อผิดพลาด เพื่อให้คุณวินิจฉัยปัญหาและจัดการข้อผิดพลาดได้อย่างถูกต้อง

รหัส คำอธิบาย
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 แบบจ่ายตามการใช้งาน หากคุณใช้แพ็กเกจราคา Blaze อยู่แล้ว โปรดติดต่อทีมสนับสนุนของ Firebase

สำคัญ: ตั้งแต่วันที่ 1 ตุลาคม 2025 แพ็กเกจราคา Blaze จะจำเป็นต้องใช้ Cloud Storage แม้กระทั่งที่เก็บข้อมูลเริ่มต้น
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=<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 ไฟล์ในไคลเอ็นต์ไม่ตรงกับขนาดของไฟล์ที่เซิร์ฟเวอร์ได้รับ โปรดลองอัปโหลดอีกครั้ง