Erros HTTP: o que significam e como investigar

Revisão técnica: 08/09/2026. Conteúdo reescrito; a data original de publicação foi preservada.

O código HTTP descreve o resultado de uma requisição, mas não identifica sozinho a causa da falha. A resposta pode vir da aplicação, do servidor, de um proxy ou de uma CDN. Registre a URL, o horário e a ação realizada antes de modificar configurações.

Erros de requisição e acesso

• 400: requisição inválida ou que o servidor não consegue processar.
• 401: faltam credenciais de autenticação válidas.
• 403: o servidor recusa atender à requisição.
• 404: o recurso solicitado não foi encontrado.
• 405: o método HTTP usado não é permitido para o recurso.
• 407: o proxy exige autenticação.
• 408: o servidor não recebeu a requisição completa no tempo esperado.
• 412: uma condição enviada nos cabeçalhos não foi atendida.
• 413: o corpo da requisição excede o tamanho aceito.
• 414: a URI solicitada é longa demais.
• 415: o formato do conteúdo enviado não é suportado.
• 416: o intervalo de dados solicitado não pode ser atendido.
• 429: houve excesso de requisições.

Erros do servidor e de serviços intermediários

• 500: condição inesperada impediu o atendimento.
• 502: um gateway recebeu resposta inválida do serviço de destino.
• 503: o serviço está indisponível para atender naquele momento.
• 504: um gateway não recebeu resposta do destino a tempo.

Investigue sem presumir a causa

Um 500 não comprova problema de permissão. Confira os logs correspondentes ao horário e as alterações recentes em código, configuração e dependências. Não aplique permissões amplas nem remova diretivas do .htaccess sem identificar o erro e guardar uma cópia anterior.

Um 407 não significa que o visitante foi identificado como ameaça; ele aponta para autenticação no proxy. Um 412 também não comprova bloqueio de segurança. Em uploads com 413, confira os limites nas camadas que recebem a requisição, em vez de atribuir o problema apenas à memória ou à carga do servidor.

Evite repetir automaticamente operações que podem gerar pedidos, cobranças ou alterações de dados. Antes de tentar novamente, confira se a operação anterior foi concluída. Para respostas com Retry-After, respeite a orientação de espera quando aplicável.

Reúna informações úteis para o suporte

Informe o domínio, o caminho afetado, o horário com fuso, a operação e o código recebido. Inclua o identificador da requisição, quando houver, e um trecho do log sem senhas, tokens ou dados pessoais. Compare uma página afetada com outra que funciona para delimitar o problema.

Para conteúdos removidos, veja como tratar o erro 404. Para mudanças de endereço, confira quando usar redirecionamento 301.

Referências: códigos HTTP na MDN e efeitos das respostas HTTP sobre o rastreamento.