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

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

หากไม่แน่ใจ ให้ตรวจสอบตัวแฮนเดิลข้อผิดพลาด (หรือฟังก์ชัน catch() สำหรับ Promise) และดูว่าข้อความแสดงข้อผิดพลาดระบุว่าอย่างไร

หากคุณได้ตรวจสอบข้อความแสดงข้อผิดพลาดและมีCloud Storage Security Rulesที่อนุญาตให้ดำเนินการ แต่ยังคงแก้ปัญหาข้อผิดพลาดไม่ได้ โปรดไปที่หน้าการสนับสนุนและแจ้งให้เราทราบว่าเราจะช่วยคุณได้อย่างไร

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

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

หากต้องการวินิจฉัยปัญหาและจัดการข้อผิดพลาดอย่างถูกต้อง โปรดดูรายการข้อผิดพลาดทั้งหมดที่ไคลเอ็นต์ของเราจะแจ้งและวิธีที่ข้อผิดพลาดเกิดขึ้น

รหัส เหตุผล
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=&ltTOKEN>
storage/invalid-argument อาร์กิวเมนต์ที่ส่งไปยัง put() ต้องเป็นอาร์เรย์ `File`, `Blob` หรือ `UInt8` อาร์กิวเมนต์ที่ส่งไปยัง putString() ต้องเป็น สตริงดิบ, `Base64` หรือ `Base64URL`
storage/no-default-bucket ไม่ได้ตั้งค่าที่เก็บข้อมูลในพร็อพเพอร์ตี้ storageBucket ของการกำหนดค่า Firebase
storage/cannot-slice-blob มักเกิดขึ้นเมื่อไฟล์ในเครื่องมีการเปลี่ยนแปลง (ลบ บันทึกอีกครั้ง ฯลฯ) ลองอัปโหลดอีกครั้งหลังจากยืนยันว่าไฟล์ไม่ได้ เปลี่ยนแปลง
storage/server-file-wrong-size ไฟล์ในไคลเอ็นต์มีขนาดไม่ตรงกับขนาดของไฟล์ที่เซิร์ฟเวอร์ได้รับ โปรดลองอัปโหลดอีกครั้ง