Às vezes, quando você cria um app, as coisas não saem como planejado e um erro ocorre.
Em caso de dúvida, verifique o gerenciador de erros (ou a função catch() para Promises)
e veja o que a mensagem de erro diz.
Se você verificar a mensagem de erro e tiver Cloud Storage Security Rules que permitam sua ação, mas ainda assim continuar com dificuldades para corrigir o erro, acesse nossa página de suporte e diga como podemos ajudar.
Solucionar mensagens de erro
Há diversos motivos pelos quais erros podem ocorrer, como um arquivo não existente, usuário sem permissão para acessar o arquivo desejado ou cancelamento do upload do arquivo por parte do usuário.
Para diagnosticar o problema corretamente e tratar o erro, veja uma lista completa de todos os erros que são informados por nosso cliente e como eles ocorrem.
| Código | Motivo |
|---|---|
storage/unknown |
Ocorreu um erro desconhecido. |
storage/object-not-found |
Nenhum objeto na referência desejada. |
storage/bucket-not-found |
Não há buckets configurados para o Cloud Storage |
storage/project-not-found |
Não há projetos configurados para o Cloud Storage |
storage/quota-exceeded |
A cota do seu bucket do Cloud Storage foi excedida. Se você estiver no nível sem custo financeiro, faça upgrade para um plano pago. Se você estiver em um plano pago, entre em contato com o suporte do Firebase. |
storage/unauthenticated |
O usuário não está autenticado. Faça a autenticação e tente novamente. |
storage/unauthorized |
O usuário não está autorizado a executar a ação desejada. Verifique suas regras de segurança para garantir que estejam corretas. |
storage/retry-limit-exceeded |
O limite máximo de tempo em uma operação (upload, download, exclusão etc.) foi excedido. Envie novamente. |
storage/invalid-checksum |
O arquivo no cliente não corresponde à soma de verificação do arquivo recebido pelo servidor. Envie novamente. |
storage/canceled |
O usuário cancelou a operação. |
storage/invalid-event-name |
Nome inválido do evento fornecido. Precisa ser um dos valores
[`running`, `progress`, `pause`] |
storage/invalid-url |
URL inválido fornecido para refFromURL(). Deve estar no formato: gs://bucket/object ou https://firebasestorage.googleapis.com/v0/b/bucket/o/object?token=<TOKEN>. |
storage/invalid-argument |
O argumento transmitido a put() precisa ser matriz "File", "Blob" ou "UInt8". O argumento transmitido a putString() precisa ser uma string bruta "Base64" ou "Base64URL". |
storage/no-default-bucket |
Nenhum bucket foi definido na propriedade storageBucket da configuração. |
storage/cannot-slice-blob |
Em geral, isso ocorre normalmente quando o arquivo local é alterado (excluído, salvo novamente etc.). Tente fazer o upload novamente após verificar que o arquivo não foi alterado. |
storage/server-file-wrong-size |
O arquivo no cliente não corresponde ao tamanho do arquivo recebido pelo servidor. Envie novamente. |