Códigos de erro para condições de falha do FCM.
| Erro de código | Descrição e etapas de resolução |
|---|---|
UNSPECIFIED_ERROR Não há mais informações disponíveis sobre esse erro. | Nenhum. |
INVALID_ARGUMENT (código de erro HTTP = 400) Os parâmetros da solicitação eram inválidos. Uma extensão do tipo google.rpc.BadRequest é retornada para especificar qual campo era inválido. | As possíveis causas incluem registro inválido, nome de pacote inválido, mensagem muito grande, chave de dados inválida, TTL inválido ou outros parâmetros inválidos. Registro inválido : Verifique o formato do token de registro que você passa para o servidor. Certifique-se de que ele corresponda ao token de registro que o aplicativo cliente recebe ao se registrar no FCM. Não trunque o token nem adicione caracteres adicionais. Nome de pacote inválido : certifique-se de que a mensagem foi endereçada a um token de registro cujo nome de pacote corresponda ao valor passado na solicitação. Mensagem muito grande : verifique se o tamanho total dos dados de carga incluídos em uma mensagem não excede os limites do FCM: 4.096 bytes para a maioria das mensagens ou 2.048 bytes no caso de mensagens para tópicos. Isso inclui as chaves e os valores. Chave de dados inválida : verifique se os dados da carga útil não contêm uma chave (como from, ou gcm, ou qualquer valor prefixado pelo google) que seja usada internamente pelo FCM. Observe que algumas palavras (como colapso_key) também são usadas pelo FCM, mas são permitidas na carga útil; nesse caso, o valor da carga útil será substituído pelo valor do FCM. TTL inválido : verifique se o valor usado em ttl é um número inteiro que representa uma duração em segundos entre 0 e 2.419.200 (4 semanas). Parâmetros inválidos : verifique se os parâmetros fornecidos têm o nome e o tipo corretos. |
UNREGISTERED (código de erro HTTP = 404) O registro da instância do aplicativo foi cancelado no FCM. Isso geralmente significa que o token usado não é mais válido e um novo deve ser usado. | Este erro pode ser causado pela falta de tokens de registro ou por tokens não registrados. Registro ausente : se o destino da mensagem for um valor token , verifique se a solicitação contém um token de registro.Não registrado : um token de registro existente pode deixar de ser válido em vários cenários, incluindo: - Se o aplicativo cliente cancelar o registro no FCM. - Se o registro do aplicativo cliente for automaticamente cancelado, o que pode acontecer se o usuário desinstalar o aplicativo. Por exemplo, no iOS, se o Serviço de Feedback de APNs reportar o token de APNs como inválido. - Se o token de registro expirar (por exemplo, o Google pode decidir atualizar os tokens de registro ou o token de APNs expirou para dispositivos iOS). - Se o aplicativo cliente estiver atualizado, mas a nova versão não estiver configurada para receber mensagens. Para todos esses casos, remova esse token de registro do servidor do aplicativo e pare de usá-lo para enviar mensagens. |
SENDER_ID_MISMATCH (código de erro HTTP = 403) O ID do remetente autenticado é diferente do ID do remetente do token de registro. | Um token de registro está vinculado a um determinado grupo de remetentes. Quando um aplicativo cliente se registra no FCM, ele precisa especificar quais remetentes têm permissão para enviar mensagens. Você deve usar um desses IDs de remetente ao enviar mensagens para o aplicativo cliente. Se você mudar para um remetente diferente, os tokens de registro existentes não funcionarão. |
QUOTA_EXCEEDED (código de erro HTTP = 429) Limite de envio excedido para o destino da mensagem. Uma extensão do tipo google.rpc.QuotaFailure é retornada para especificar qual cota foi excedida. | Este erro pode ser causado por cota de taxa de mensagens excedida, cota de taxa de mensagens do dispositivo excedida ou cota de taxa de mensagens de tópico excedida. Taxa de mensagens excedida : A taxa de envio de mensagens é muito alta. Você deve reduzir a taxa geral de envio de mensagens. Use espera exponencial com atraso inicial mínimo de 1 minuto para tentar novamente mensagens rejeitadas. Taxa de mensagens do dispositivo excedida : A taxa de mensagens para um dispositivo específico é muito alta. Consulte limite de taxa de mensagens para um único dispositivo . Reduza o número de mensagens enviadas para este dispositivo e use a espera exponencial para tentar enviar novamente. Taxa de mensagens do tópico excedida : a taxa de mensagens para assinantes de um determinado tópico é muito alta. Reduza o número de mensagens enviadas para este tópico e use espera exponencial com atraso inicial mínimo de 1 minuto para tentar enviar novamente. |
UNAVAILABLE (código de erro HTTP = 503) O servidor está sobrecarregado. | O servidor não conseguiu processar a solicitação a tempo. Tente novamente a mesma solicitação, mas você deve: - Respeite o cabeçalho Retry-After se ele estiver incluído na resposta do FCM Connection Server. - Implemente a retirada exponencial em seu mecanismo de nova tentativa. (por exemplo, se você esperou um segundo antes da primeira tentativa, espere pelo menos dois segundos antes da próxima, depois 4 segundos e assim por diante). Se você estiver enviando várias mensagens, considere aplicar tremulação. Para obter mais informações, consulte Tratamento de novas tentativas . Remetentes que causam problemas correm o risco de serem colocados na lista negra. |
INTERNAL (código de erro HTTP = 500) Ocorreu um erro interno desconhecido. | O servidor encontrou um erro ao tentar processar a solicitação. Você pode tentar novamente a mesma solicitação seguindo as sugestões em Tratamento de novas tentativas . Se o erro persistir, entre em contato com o suporte do Firebase. |
THIRD_PARTY_AUTH_ERROR (código de erro HTTP = 401) O certificado de APNs ou a chave de autenticação web push eram inválidos ou ausentes. | Não foi possível enviar uma mensagem direcionada a um dispositivo iOS ou um registro web push. Verifique a validade de suas credenciais de desenvolvimento e produção. |