Mã lỗi cho các điều kiện lỗi FCM.
| Mã lỗi | Các bước mô tả và giải quyết |
|---|---|
UNSPECIFIED_ERROR Không có thêm thông tin nào về lỗi này. | Không có. |
INVALID_ARGUMENT (Mã lỗi HTTP = 400) Tham số yêu cầu không hợp lệ. Phần mở rộng thuộc loại google.rpc.BadRequest được trả về để chỉ định trường nào không hợp lệ. | Các nguyên nhân tiềm ẩn bao gồm đăng ký không hợp lệ, tên gói không hợp lệ, tin nhắn quá lớn, khóa dữ liệu không hợp lệ, TTL không hợp lệ hoặc các tham số không hợp lệ khác. Đăng ký không hợp lệ : Kiểm tra định dạng của mã thông báo đăng ký bạn chuyển đến máy chủ. Đảm bảo rằng nó khớp với mã thông báo đăng ký mà ứng dụng khách nhận được khi đăng ký với FCM. Không cắt bớt mã thông báo hoặc thêm ký tự bổ sung. Tên gói không hợp lệ : Đảm bảo thư được gửi tới mã thông báo đăng ký có tên gói khớp với giá trị được chuyển trong yêu cầu. Tin nhắn quá lớn : Kiểm tra để đảm bảo tổng kích thước của dữ liệu tải trọng có trong tin nhắn không vượt quá giới hạn FCM: 4096 byte cho hầu hết các tin nhắn hoặc 2048 byte trong trường hợp tin nhắn đến chủ đề. Điều này bao gồm cả khóa và giá trị. Khóa dữ liệu không hợp lệ : Kiểm tra để đảm bảo rằng dữ liệu tải trọng không chứa khóa (chẳng hạn như từ, hoặc gcm hoặc bất kỳ giá trị nào được bắt đầu bởi google) được FCM sử dụng nội bộ. Lưu ý rằng một số từ (chẳng hạn như thu gọn_key) cũng được FCM sử dụng nhưng được phép trong tải trọng, trong trường hợp đó giá trị tải trọng sẽ bị ghi đè bởi giá trị FCM. TTL không hợp lệ : Kiểm tra xem giá trị được sử dụng trong ttl có phải là số nguyên biểu thị thời lượng tính bằng giây trong khoảng từ 0 đến 2.419.200 (4 tuần). Tham số không hợp lệ : Kiểm tra xem các tham số được cung cấp có đúng tên và loại hay không. |
CHƯA UNREGISTERED (mã lỗi HTTP = 404) Phiên bản ứng dụng đã bị hủy đăng ký khỏi FCM. Điều này thường có nghĩa là mã thông báo được sử dụng không còn hợp lệ và phải sử dụng mã mới. | Lỗi này có thể do thiếu mã thông báo đăng ký hoặc mã thông báo chưa được đăng ký. Thiếu đăng ký : Nếu mục tiêu của tin nhắn là giá trị token , hãy kiểm tra xem yêu cầu có chứa mã thông báo đăng ký hay không.Chưa được đăng ký : Mã thông báo đăng ký hiện có có thể không còn hiệu lực trong một số trường hợp, bao gồm: - Nếu ứng dụng khách hủy đăng ký với FCM. - Nếu ứng dụng khách tự động bị hủy đăng ký, điều này có thể xảy ra nếu người dùng gỡ cài đặt ứng dụng. Ví dụ: trên iOS, nếu Dịch vụ phản hồi của APN báo cáo mã thông báo APN là không hợp lệ. - Nếu mã thông báo đăng ký hết hạn (ví dụ: Google có thể quyết định làm mới mã thông báo đăng ký hoặc mã thông báo APN đã hết hạn đối với thiết bị iOS). - Nếu ứng dụng khách được cập nhật nhưng phiên bản mới không được cấu hình để nhận tin nhắn. Đối với tất cả các trường hợp này, hãy xóa mã thông báo đăng ký này khỏi máy chủ ứng dụng và ngừng sử dụng nó để gửi tin nhắn. |
SENDER_ID_MISMATCH (Mã lỗi HTTP = 403) ID người gửi được xác thực khác với ID người gửi cho mã thông báo đăng ký. | Mã thông báo đăng ký được gắn với một nhóm người gửi nhất định. Khi ứng dụng khách đăng ký FCM, ứng dụng đó phải chỉ định người gửi nào được phép gửi tin nhắn. Bạn nên sử dụng một trong những ID người gửi đó khi gửi tin nhắn đến ứng dụng khách. Nếu bạn chuyển sang người gửi khác, mã thông báo đăng ký hiện tại sẽ không hoạt động. |
QUOTA_EXCEEDED (Mã lỗi HTTP = 429) Đã vượt quá giới hạn gửi đối với mục tiêu thư. Phần mở rộng thuộc loại google.rpc.QuotaFailure được trả về để chỉ định hạn ngạch nào đã bị vượt quá. | Lỗi này có thể do vượt quá hạn mức tốc độ tin nhắn, vượt quá hạn mức tốc độ tin nhắn trên thiết bị hoặc vượt quá hạn mức tốc độ tin nhắn theo chủ đề. Đã vượt quá tốc độ tin nhắn : Tốc độ gửi tin nhắn quá cao. Bạn phải giảm tốc độ gửi tin nhắn chung. Sử dụng thời gian chờ theo cấp số nhân với độ trễ ban đầu tối thiểu là 1 phút để thử lại các tin nhắn bị từ chối. Đã vượt quá tốc độ tin nhắn của thiết bị : Tỷ lệ tin nhắn đến một thiết bị cụ thể quá cao. Xem giới hạn tốc độ tin nhắn cho một thiết bị . Giảm số lượng tin nhắn được gửi tới thiết bị này và sử dụng thời gian chờ theo cấp số nhân để thử gửi lại. Đã vượt quá tỷ lệ tin nhắn chủ đề : Tỷ lệ tin nhắn tới người đăng ký một chủ đề cụ thể quá cao. Giảm số lượng thư được gửi cho chủ đề này và sử dụng thời gian chờ theo cấp số nhân với độ trễ ban đầu tối thiểu là 1 phút để thử gửi lại. |
UNAVAILABLE CÓ (Mã lỗi HTTP = 503) Máy chủ bị quá tải. | Máy chủ không thể xử lý yêu cầu kịp thời. Hãy thử lại yêu cầu tương tự, nhưng bạn phải: - Tôn trọng tiêu đề Retry-After nếu nó được bao gồm trong phản hồi từ Máy chủ kết nối FCM. - Triển khai dự phòng theo cấp số nhân trong cơ chế thử lại của bạn. (ví dụ: nếu bạn đợi một giây trước lần thử lại đầu tiên, hãy đợi ít nhất hai giây trước lần thử tiếp theo, sau đó là 4 giây, v.v.). Nếu bạn đang gửi nhiều tin nhắn, hãy cân nhắc việc áp dụng hiện tượng jitter. Để biết thêm thông tin, hãy xem Xử lý lần thử lại . Người gửi gây ra vấn đề có nguy cơ bị từ chối. |
INTERNAL (Mã lỗi HTTP = 500) Đã xảy ra lỗi nội bộ không xác định. | Máy chủ gặp lỗi khi cố gắng xử lý yêu cầu. Bạn có thể thử lại yêu cầu tương tự theo các đề xuất trong Xử lý lần thử lại . Nếu lỗi vẫn tiếp diễn, vui lòng liên hệ với bộ phận hỗ trợ của Firebase. |
THIRD_PARTY_AUTH_ERROR (Mã lỗi HTTP = 401) Chứng chỉ APN hoặc khóa xác thực đẩy web không hợp lệ hoặc bị thiếu. | Không thể gửi tin nhắn được nhắm mục tiêu đến thiết bị iOS hoặc đăng ký đẩy web. Kiểm tra tính hợp lệ của thông tin phát triển và sản xuất của bạn. |