Watch demos on how to build & run AI-powered apps with Firebase at Demo Day '24. Watch now.

Trang này được dịch bởi Cloud Translation API.

Xử lý lỗi cho Cloud Storage trên các nền tảng của Apple

Đôi khi, khi bạn đang tạo một ứng dụng, mọi thứ không diễn ra như dự kiến và một lỗi sẽ xảy ra.

Khi không chắc chắn, hãy kiểm tra lỗi được trả về và xem thông báo lỗi.

Lưu ý: Theo mặc định, bộ chứa Cloud Storage for Firebase yêu cầu Firebase Authentication thực hiện bất kỳ thao tác nào trên dữ liệu hoặc tệp của bộ chứa. Bạn có thể thay đổi Firebase Security Rules thành Cloud Storage để cho phép truy cập không xác thực trong một số trường hợp cụ thể. Tuy nhiên, trong hầu hết các trường hợp, bạn nên hạn chế quyền truy cập và thiết lập các quy tắc bảo mật mạnh mẽ (đặc biệt là đối với các ứng dụng phát hành công khai). Xin lưu ý rằng nếu sử dụng Google App Engine và có bộ chứa Cloud Storage mặc định có định dạng tên là *.appspot.com, bạn có thể cần cân nhắc mức độ ảnh hưởng của các quy tắc bảo mật đối với quyền truy cập vào tệp App Engine.

Nếu bạn đã kiểm tra thông báo lỗi và có Cloud Storage Security Rules cho phép hành động của mình, nhưng vẫn gặp khó khăn trong việc khắc phục lỗi, hãy truy cập vào Trang hỗ trợ của chúng tôi và cho chúng tôi biết cách chúng tôi có thể trợ giúp.

Xử lý thông báo lỗi

Có một số lý do khiến lỗi có thể xảy ra, bao gồm cả việc tệp không tồn tại, người dùng không có quyền truy cập vào tệp mong muốn hoặc người dùng huỷ tải tệp lên.

Để chẩn đoán đúng cách vấn đề và xử lý lỗi, sau đây là danh sách đầy đủ tất cả lỗi mà ứng dụng của chúng tôi sẽ đưa ra và cách lỗi có thể xảy ra.

Tên	Lý do
`FIRStorageErrorCodeUnknown`	Đã xảy ra lỗi không xác định.
`FIRStorageErrorCodeObjectNotFound`	Không có đối tượng nào tồn tại tại tham chiếu đã chỉ định.
`FIRStorageErrorCodeBucketNotFound`	Không có bộ chứa nào được định cấu hình cho Cloud Storage.
`FIRStorageErrorCodeProjectNotFound`	Không có dự án nào được định cấu hình cho Cloud Storage.
`FIRStorageErrorCodeQuotaExceeded`	Hạn mức trên bộ chứa Cloud Storage của bạn đã vượt quá. Nếu bạn đang sử dụng gói giá Spark, hãy cân nhắc nâng cấp lên gói giá linh hoạt Blaze (trả phí theo mức sử dụng). Nếu bạn đã sử dụng gói giá Blaze, hãy liên hệ với Nhóm hỗ trợ Firebase. Lưu ý quan trọng: Kể từ ngày 1 tháng 10 năm 2025, bạn phải sử dụng gói giá Blaze để sử dụng Cloud Storage, ngay cả các bộ chứa mặc định.
`FIRStorageErrorCodeUnauthenticated`	Người dùng chưa được xác thực. Xác thực rồi thử lại.
`FIRStorageErrorCodeUnauthorized`	Người dùng không được phép thực hiện hành động được yêu cầu. Kiểm tra các quy tắc của bạn để đảm bảo chúng chính xác.
`FIRStorageErrorCodeRetryLimitExceeded`	Đã vượt quá giới hạn thời gian tối đa cho một thao tác (tải lên, tải xuống, xoá, v.v.). Hãy thử tải lên lại.
`FIRStorageErrorCodeNonMatchingChecksum`	Tệp trên máy khách không khớp với tổng kiểm của tệp mà máy chủ nhận được. Hãy thử tải lên lại.
`FIRStorageErrorCodeCanceled`	Người dùng đã huỷ thao tác.
`FIRStorageErrorCodeDownloadSizeExceeded`	Kích thước của tệp đã tải xuống vượt quá dung lượng bộ nhớ được phân bổ cho quá trình tải xuống. Tăng giới hạn bộ nhớ rồi thử tải xuống lại.