O Alibaba Cloud CDN retorna códigos de status HTTP padrão quando ocorrem erros. Esta referência descreve todos os códigos 4xx e 5xx que o CDN pode retornar, explica o significado de cada um no contexto do CDN e lista etapas concretas para resolução.
Códigos de status 4xx
Os códigos 4xx indicam erros no lado do cliente. A solicitação chegou à rede CDN, mas não foi atendida devido a um problema na própria solicitação ou à falta de permissões ou credenciais necessárias no cliente.
400 Bad Request
O servidor de origem não conseguiu interpretar ou processar a solicitação devido a sintaxe malformada ou parâmetros inválidos.
Resolução: Verifique se há erros nos parâmetros da solicitação e reenvie-a.
401 Unauthorized
A solicitação não incluiu credenciais de autenticação válidas. O servidor de origem exige autenticação antes de processar a solicitação.
Resolução: Inclua credenciais de autenticação válidas e tente novamente. Se a autenticação for gerenciada no servidor de origem, autorize a solicitação primeiro nesse servidor.
403 Forbidden
O servidor de origem entendeu a solicitação, mas recusou o atendimento porque o cliente não tem permissão para acessar o recurso.
Resolução: Conceda as permissões necessárias ao cliente e tente novamente.
404 Not Found
O servidor de origem não encontrou o recurso solicitado.
Resolução:
Verifique se o caminho da solicitação está correto.
Confirme se o recurso existe no servidor de origem.
Verifique se o caminho da URL do servidor de origem é acessível pela internet.
405 Method Not Allowed
O servidor de origem reconhece o recurso, mas não aceita o método HTTP utilizado (por exemplo, envio de POST para um endpoint que aceita apenas GET).
Resolução: Altere a solicitação para um método HTTP aceito pelo servidor de origem e tente novamente.
406 Not Acceptable
O servidor de origem não pode retornar o recurso em um formato que satisfaça os cabeçalhos de negociação de conteúdo do cliente (por exemplo, Accept-Charset ou Accept-Language).
Resolução: Atualize os cabeçalhos da solicitação para especificar tipos de conteúdo e codificações aceitos pelo servidor de origem e tente novamente.
407 Proxy Authentication Required
O cliente não forneceu as credenciais de autenticação exigidas pelo servidor proxy entre o cliente e a origem.
Resolução:
Verifique se a autenticação do servidor de origem via proxy expirou.
Inclua as credenciais corretas emitidas pelo servidor de origem via proxy.
Tente a solicitação novamente.
408 Request Timeout
O servidor de origem não recebeu a solicitação completa dentro da janela de tempo limite e encerrou a conexão.
Resolução: Estenda o período de tempo limite do servidor de origem ou reduza o tamanho do payload da solicitação e tente novamente.
409 Conflict
A solicitação entra em conflito com o estado atual do recurso de destino. Isso ocorre frequentemente com solicitações PUT quando um cliente tenta atualizar um recurso modificado desde a última recuperação.
Resolução: Atualize o recurso, incorpore quaisquer alterações e reenvie a solicitação. Como alternativa, adicione lógica de tratamento de conflitos no servidor de origem.
410 Gone
O recurso foi removido intencional e permanentemente do servidor de origem.
Resolução: Remova todas as referências ao recurso excluído em seu cliente ou aplicação. Diferentemente do 404, o código 410 sinaliza uma remoção permanente; não tente novamente indefinidamente.
411 Length Required
A solicitação não contém o cabeçalho Content-Length, necessário para que o servidor de origem processe o corpo da solicitação.
Resolução:
Se o tamanho do conteúdo for conhecido, adicione
Content-Length: <size>ao cabeçalho da solicitação.Caso não seja possível determinar o tamanho antecipadamente, utilize
Transfer-Encoding: chunked.
412 Precondition Failed
O servidor de origem avaliou os cabeçalhos condicionais na solicitação (por exemplo, If-Match ou If-Unmodified-Since) e a pré-condição não foi atendida.
Resolução: Atualize a solicitação para incluir pré-condições válidas e atuais e tente novamente.
413 Payload Too Large
O payload da solicitação excede o tamanho máximo configurado para aceitação pelo servidor de origem.
Resolução: Reduza o tamanho do upload ou envio e tente novamente.
414 URI Too Long
A URI da solicitação é mais longa do que o servidor de origem consegue processar.
Resolução: Encurte a URI. Se a solicitação contiver muitos parâmetros, divida-os em várias solicitações e agregue os resultados no lado do cliente.
415 Unsupported Media Type
O payload da solicitação está em um formato não aceito pelo servidor de origem.
Resolução: Defina Content-Type no cabeçalho da solicitação para um tipo de mídia aceito pelo servidor de origem e tente novamente.
416 Range Not Satisfiable
O cabeçalho Range na solicitação especifica um intervalo de bytes fora dos limites do recurso.
Resolução: Verifique se o intervalo no cabeçalho Range é válido para o tamanho do recurso, corrija-o e tente novamente.
417 Expectation Failed
O servidor de origem não pôde atender à expectativa especificada no cabeçalho de solicitação Expect.
Resolução: Este código aparece mais comumente durante testes. Se ocorrer em produção, desative o campo Expect no cabeçalho da solicitação.
429 Too Many Requests
O cliente excedeu o limiar de limitação de taxa do servidor de origem dentro de uma determinada janela de tempo.
Resolução: Aguarde e tente novamente após o intervalo indicado pelo cabeçalho de resposta Retry-After (se presente) ou após a redefinição da janela de limite de taxa definida pelo servidor de origem.
499 Client Closed Request
O cliente fechou a conexão antes que o servidor terminasse de processar a solicitação e enviar uma resposta.
Isso geralmente acontece quando os clientes atingem o tempo limite localmente durante operações lentas, como uploads de arquivos grandes ou chamadas de API demoradas. Como o cliente já se desconectou, ele não recebe nenhuma página de erro.
Códigos de status 5xx
500 Internal Server Error
O servidor de origem encontrou um erro interno e não conseguiu processar a solicitação.
Resolução:
Verifique os logs de erro do servidor de origem para identificar a causa raiz.
Se uma implantação recente causou o erro, reverta para a última versão funcional para restaurar o service.
Corrija o problema subjacente e confirme se a origem está respondendo corretamente antes de tentar novamente.
502 Bad Gateway
Um POP do CDN não conseguiu se conectar ao seu servidor de origem e não recebeu uma resposta válida.
Resolução:
Confirme se o servidor de origem está em execução e acessível.
Verifique as regras de firewall do servidor de origem para garantir que o tráfego de entrada dos POPs do CDN seja permitido.
Revise os logs do servidor de origem em busca de erros de conexão.
503 Service Unavailable
O servidor de origem está temporariamente sobrecarregado e incapaz de lidar com a solicitação.
Resolução:
Verifique a carga no servidor de origem para identificar qual aplicação ou processo está consumindo recursos excessivos.
504 Gateway Timeout
Um POP do CDN enviou uma solicitação ao seu servidor de origem, mas não recebeu resposta dentro do período de tempo limite configurado.
Resolução:
Confirme se o servidor de origem está disponível e acessível.
Verifique o desempenho do servidor de origem. Consultas lentas ao banco de dados ou processos demorados podem causar tempos limite.
Se a origem realmente precisar de mais tempo para responder, aumente o período de tempo limite conforme necessário.
508 Loop Detected
Uma solicitação encaminhada por um POP do CDN foi redirecionada de volta para a rede CDN, criando um loop infinito que excedeu o limite máximo de redirecionamento.
Isso geralmente acontece quando o servidor de origem ou uma regra de redirecionamento envia o tráfego de volta para o domínio do CDN que iniciou a solicitação.
Resolução:
Verifique seu servidor de origem e quaisquer regras de redirecionamento em busca de referências circulares.
Garanta que cada loop ou cadeia de redirecionamento tenha uma condição de término.
Após corrigir o loop, tente a solicitação novamente.