Admin FCM API 오류

다음은 Firebase Admin FCM API에서 발생하는 오류 코드와 설명, 권장 해결 단계를 모두 포함한 목록입니다.

오류 코드 설명 및 해결 단계
messaging/invalid-argument FCM 메소드에 잘못된 인수가 제공되었습니다. 오류 메시지에 추가 정보가 들어 있습니다.
messaging/invalid-recipient 의도된 메시지 수신자가 잘못되었습니다. 오류 메시지에 추가 정보가 들어 있습니다. 다양한 수신자 유형으로 올바르게 메시지를 보내는 방법은 메시지 보내기를 참조하세요.
messaging/invalid-payload 잘못된 메시지 페이로드 객체가 제공되었습니다. 오류 메시지에 추가 정보가 들어 있습니다. 메시지 페이로드를 올바르게 정의하는 방법은 메시지 페이로드 정의를 참조하세요.
messaging/invalid-data-payload-key 데이터 메시지 페이로드에 잘못된 키가 있습니다. DataMessagePayload 참조 문서에서 제한된 키를 확인하세요.
messaging/payload-size-limit-exceeded 제공된 메시지 페이로드가 FCM 크기 한도를 초과합니다. 대부분의 메시지는 4096바이트로 제한됩니다. 주제로 보낸 메시지는 2048바이트로 제한됩니다. 전체 페이로드 크기에는 키와 값이 모두 포함됩니다.
messaging/invalid-options 잘못된 메시지 옵션 객체가 제공되었습니다. 오류 메시지에 추가 정보가 들어 있습니다. 메시지 옵션을 올바르게 정의하는 방법의 자세한 내용은 메시지 옵션 정의를 참조하세요.
messaging/invalid-registration-token 잘못된 등록 토큰이 제공되었습니다. FCM에 등록할 때 클라이언트 앱에서 수신한 등록 토큰과 일치해야 합니다. 어떠한 문자도 빼거나 더해서는 안 됩니다.
messaging/registration-token-not-registered 제공된 등록 토큰이 등록되지 않았습니다. 이전에 유효했던 등록 토큰이 다음을 비롯한 여러 가지 이유로 등록 취소되었을 수 있습니다.
  • 클라이언트 앱이 FCM에서 등록 취소되었습니다.
  • 클라이언트 앱이 자동으로 등록 취소되었습니다. 사용자가 애플리케이션을 제거했거나 iOS에서 APNS 피드백 서비스가 APNS 토큰이 잘못되었다고 보고한 경우일 수 있습니다.
  • 등록 토큰이 만료되었습니다. 예를 들어 Google에서 등록 토큰 새로고침을 결정했거나 iOS 기기의 APNS 토큰이 만료되었을 수 있습니다.
  • 클라이언트 앱이 업데이트되었지만 새 버전이 메시지를 수신하도록 구성되지 않았습니다.
위와 같은 경우에는 등록 토큰을 삭제하고 더 이상 메시지 전송에 이 등록 토큰을 사용하지 마세요.
messaging/invalid-package-name 메시지를 보낼 대상으로 지정한 등록 토큰의 패키지 이름이 제공된 restrictedPackageName 옵션과 일치하지 않습니다.
messaging/message-rate-exceeded 특정 대상으로 전달되는 메시지 비율이 너무 높습니다. 이 기기 또는 주제로 보내는 메시지 수를 줄이세요. 이 대상으로 바로 다시 보내도록 시도해서는 안 됩니다.
messaging/device-message-rate-exceeded 특정 기기로 전달되는 메시지 비율이 너무 높습니다. 이 기기로 보내는 메시지 수를 줄이세요. 이 기기로 바로 다시 보내도록 시도해서는 안 됩니다.
messaging/topics-message-rate-exceeded 특정 주제의 구독자에게 전달되는 메시지 비율이 너무 높습니다. 이 주제로 보내는 메시지 수를 줄이세요. 바로 다시 보내도록 시도해서는 안 됩니다.
messaging/too-many-topics 등록 토큰에서 구독하는 주제 수가 최대값에 도달하여 더 이상 구독할 수 없습니다.
messaging/invalid-apns-credentials 필수 APN SSL 인증서가 업로드되지 않았거나 만료되어 iOS 기기를 대상으로 메시지를 보낼 수 없습니다. 개발 및 프로덕션 인증서의 유효성을 확인하세요.
messaging/mismatched-credential 이 SDK를 인증하는 데 사용된 인증 정보에 제공된 등록 토큰에 해당하는 기기로 메시지를 보낼 권한이 없습니다. 인증 정보와 등록 토큰이 동일한 Firebase 프로젝트에 속하는지 확인하세요. Admin SDK를 인증하는 방법은 앱에 Firebase 추가를 참조하세요.
messaging/authentication-error SDK에서 FCM 서버에 인증할 수 없습니다. FCM 메시지를 보낼 권한이 있는 인증 정보를 사용하여 Admin SDK를 인증해야 합니다. Admin SDK를 인증하는 방법은 앱에 Firebase 추가를 참조하세요.
messaging/server-unavailable FCM 서버에서 시간 내에 요청을 처리하지 못했습니다. 동일한 요청을 다시 시도하되 다음을 수행해야 합니다.
  • Retry-After 헤더가 FCM 연결 서버의 응답에 포함된 경우 이 헤더를 반영합니다.
  • 재시도 방식에서 지수 백오프를 구현합니다. 예를 들어 첫 번째 재시도 전에 1초 동안 기다렸다면 다음에는 2초, 다음에는 4초 동안 기다리는 식으로 대기 시간을 점차 늘립니다. 여러 메시지를 보내는 경우에는 모든 메시지를 동시에 새로 요청하지 않도록 메시지마다 개별적으로 무작위 지연 시간을 추가하세요.
문제를 유발하는 발신자는 차단될 수 있습니다.
messaging/internal-error 요청을 처리하려고 시도하는 중에 FCM 서버에서 오류가 발생했습니다. 위 messaging/server-unavailable 행에 제시된 요구사항에 따라 동일한 요청을 재시도할 수 있습니다. 오류가 계속되면 버그 신고 지원 채널에 문제를 신고하시기 바랍니다.
messaging/unknown-error 알 수 없는 서버 오류가 반환되었습니다. 자세한 내용은 오류 메시지의 원시 서버 응답을 참조하세요. 이 오류가 발생하면 버그 신고 지원 채널에 전체 오류 메시지를 신고하시기 바랍니다.

다음에 대한 의견 보내기...

도움이 필요하시나요? 지원 페이지를 방문하세요.