Às vezes, quando você está criando um aplicativo, as coisas não saem como planejado e ocorre um erro!
Em caso de dúvida, verifique o manipulador de erros (ou a função catch() para Promises) e veja o que a mensagem de erro tem a dizer.
Se você verificou a mensagem de erro e possui regras de segurança de armazenamento em nuvem que permitem sua ação, mas ainda está com dificuldades para resolver o erro, visite nossa página de suporte e diga-nos como podemos ajudar.
Lidar com mensagens de erro
Existem vários motivos pelos quais podem ocorrer erros, incluindo a inexistência do arquivo, o usuário não ter permissão para acessar o arquivo desejado ou o usuário cancelar o upload do arquivo.
Para diagnosticar adequadamente o problema e lidar com o erro, aqui está uma lista completa de todos os erros que nosso cliente irá levantar e como eles ocorreram.
| Código | Razão |
|---|---|
storage/unknown | Ocorreu um erro desconhecido. |
storage/object-not-found | Nenhum objeto existe na referência desejada. |
storage/bucket-not-found | Nenhum bucket está configurado para o Cloud Storage |
storage/project-not-found | Nenhum projeto está configurado para o Cloud Storage |
storage/quota-exceeded | A cota do seu bucket do Cloud Storage foi excedida. Se você estiver no nível gratuito, atualize 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. Autentique-se e tente novamente. |
storage/unauthorized | O usuário não está autorizado a realizar a ação desejada, verifique suas regras de segurança para garantir que estão corretas. |
storage/retry-limit-exceeded | O limite máximo de tempo para uma operação (upload, download, exclusão, etc.) foi excedido. Tente fazer upload novamente. |
storage/invalid-checksum | O arquivo no cliente não corresponde à soma de verificação do arquivo recebido pelo servidor. Tente fazer upload novamente. |
storage/canceled | O usuário cancelou a operação. |
storage/invalid-event-name | Nome de evento inválido fornecido. Deve ser um de [ `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 passado para put() deve ser `File`, `Blob` ou `UInt8` Array. O argumento passado para putString() deve ser uma string bruta, `Base64` ou `Base64URL`. |
storage/no-default-bucket | Nenhum bucket foi definido na propriedade storageBucket da sua configuração. |
storage/cannot-slice-blob | Geralmente ocorre quando o arquivo local foi alterado (excluído, salvo novamente, etc.). Tente fazer upload novamente depois de verificar se 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. Tente fazer upload novamente. |