À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 especificada. |
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 usando o plano de preços do Spark, considere fazer upgrade para o plano de preços do Blaze de pagamento por uso. Se você já estiver usando o plano de preços do Blaze, entre em contato com o suporte do Firebase. Importante: a partir de |
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 solicitada. Verifique as 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
do Firebase. |
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. |