Solucionar erros do Cloud Storage em plataformas da Apple

À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 erro retornado e veja o que diz a mensagem.

Observação: por padrão, um bucket Cloud Storage for Firebase exige o Firebase Authentication para realizar qualquer ação nos dados ou arquivos do bucket. É possível mudar o Firebase Security Rules para Cloud Storage e permitir o acesso não autenticado em situações específicas. No entanto, na maioria das situações, recomendamos restringir o acesso e configurar regras de segurança avançadas, em especial para apps de produção. Se você usar Google App Engine e tiver um bucket Cloud Storage padrão com um formato de nome *.appspot.com, talvez seja necessário considerar como as regras de segurança afetam o acesso aos arquivos App Engine.

Se você verificar a mensagem de erro e tiver Cloud Storage Security Rules que permitam sua ação, mas ainda está 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 corretamente o problema e solucionar o erro, veja a seguir uma lista completa de todos os erros informados por nosso cliente e como eles ocorrem.

Nome	Motivo
FIRStorageErrorCodeUnknown	Ocorreu um erro desconhecido.
FIRStorageErrorCodeObjectNotFound	Nenhum objeto na referência especificada.
FIRStorageErrorCodeBucketNotFound	Não há buckets configurados para o Cloud Storage.
FIRStorageErrorCodeProjectNotFound	Não há projetos configurados para o Cloud Storage.
FIRStorageErrorCodeQuotaExceeded	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 1º de outubro de 2025, o plano de preços do Blaze será obrigatório para usar Cloud Storage, mesmo em buckets padrão.
FIRStorageErrorCodeUnauthenticated	O usuário não está autenticado. Faça a autenticação e tente novamente.
FIRStorageErrorCodeUnauthorized	O usuário não tem autorização para realizar a ação solicitada. Verifique suas regras para garantir que estejam corretas.
FIRStorageErrorCodeRetryLimitExceeded	O limite de tempo máximo em uma operação (envio, download, exclusão etc.) foi excedido. Envie novamente.
FIRStorageErrorCodeNonMatchingChecksum	O arquivo no cliente não corresponde à soma de verificação do arquivo recebido pelo servidor. Envie novamente.
FIRStorageErrorCodeCanceled	O usuário cancelou a operação.
FIRStorageErrorCodeDownloadSizeExceeded	O tamanho do arquivo salvo excede o tamanho da memória alocada para o download. Aumente o limite de memória e tente novamente.