Ir para o console

Solucionar erros 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 erro (ou a função catch() para Promises) e veja o que diz a mensagem de erro.

Se você verificou a mensagem de erro e tem regras de segurança do Firebase Storage que permitem sua ação, mas ainda está com dificuldades para corrigir o erro, acesse nossa página de suporte e informe como podemos ajudar.

Tratar mensagens de erro

Há diversos motivos pelos quais erros podem ocorrer, como o 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 Nenhum intervalo configurado para o Cloud Storage.
storage/project-not-found Nenhum projeto configurado para o Cloud Storage.
storage/quota-exceeded A cota do intervalo do Cloud Storage foi excedida. Se você estiver no nível gratuito, 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. Deve ser um de [`running`, `progress`, `pause`]
storage/invalid-url URL inválido fornecido a 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() deve ser matriz `File`, `Blob` ou `UInt8`. O argumento transmitido a putString() deve ser string bruta `Base64` ou `Base64URL`.
storage/no-default-bucket Nenhum intervalo foi configurado na propriedade storageBucket da sua 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.