Solucionar erros do Cloud Storage na Web

À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=&ltTOKEN>.
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.