HTTP 204 No Content: o que significa

O que este erro significa e como reconhecê-lo

• Um navegador, cliente de API, ferramenta de monitoramento ou verificador de sites informa HTTP 204 No Content.
• Um navegador pode exibir um resultado em branco porque não há corpo da resposta para renderizar.
• Um cliente de API pode receber um status de sucesso sem JSON, HTML ou outra carga útil.
• O DNS pode resolver e o TLS pode ser concluído porque a solicitação chegou a um endpoint que fala HTTP.
• A resposta pode afetar apenas uma URL, um método HTTP, um estado de autenticação ou um cliente.
• Os cabeçalhos da resposta podem revelar informações sobre cache, autenticação, redirecionamento, limite de requisições ou proxy.

Causas principais, por probabilidade

1. O endpoint usa 204 intencionalmente para um resultado vazio bem-sucedido. Algumas rotas concluem uma ação sem retornar uma representação no corpo da resposta.
2. O método da solicitação ou a rota tem um comportamento de resposta diferente. O mesmo caminho pode retornar status diferentes dependendo de a solicitação ser uma leitura, atualização, exclusão ou outra operação.
3. A aplicação concluiu a solicitação, mas não tem conteúdo para retornar. Isso pode ser esperado em um endpoint de ação ou inesperado se o cliente exigir uma carga útil.
4. Um reverse proxy, CDN, WAF ou servidor web gerou ou transformou a resposta. A configuração da infraestrutura pode produzir um resultado diferente do comportamento pretendido pela aplicação.
5. A autenticação, o roteamento, o cache ou uma implantação recente alterou o caminho da resposta. Essas causas são mais prováveis quando o 204 é novo, está limitado a determinados usuários ou afeta várias rotas relacionadas.

Como corrigir

Para visitantes e usuários de API

1. Tente novamente a URL exata uma vez e confirme se o endereço está correto.
2. Observe o método HTTP usado pelo cliente. Uma rota pode se comportar de maneira diferente com métodos diferentes.
3. Se o endpoint exigir uma conta, faça login normalmente e tente novamente sem compartilhar credenciais ou dados da sessão.
4. Verifique se o cliente espera um corpo da resposta. Uma resposta 204 é bem-sucedida, mas não fornece HTML, JSON ou outro corpo para exibição.
5. Analise os cabeçalhos da resposta em busca de pistas sobre autenticação, cache, limites de requisições, redirecionamentos ou um servidor intermediário.
6. Se a resposta vazia for inesperada, envie ao proprietário do site a URL, o método, o horário, o status e os cabeçalhos sanitizados. Não inclua senhas, cookies ou segredos de API.

Para proprietários de sites e desenvolvedores

1. Reproduza a solicitação exata. Registre a URL, o método HTTP, o estado de autenticação, o status, os cabeçalhos da resposta e se o problema ocorre em um ou vários clientes.
2. Decida se o 204 é intencional. Compare o comportamento documentado da rota com a resposta esperada pelo cliente. Se o cliente exigir dados, determine se o endpoint deve retornar uma representação ou se o cliente deve tratar um resultado vazio bem-sucedido.
3. Identifique a camada geradora. Verifique se o status foi produzido pela aplicação, pelo servidor web, reverse proxy, CDN ou WAF. Compare uma resposta da origem com a resposta observada externamente somente quando você estiver autorizado e puder fazer isso com segurança.
4. Inspecione os logs correspondentes. Use o horário, a rota, o método e o identificador da solicitação, se disponível, para encontrar o registro correspondente da aplicação ou da infraestrutura.
5. Compare alterações recentes. Analise implantações, roteamento, autenticação, cache e configurações de proxy e WAF em busca de mudanças que possam afetar essa solicitação.
6. Aplique a correção segura mais específica possível. Não desative amplamente a autenticação, os controles de segurança ou o cache para testar um único 204. Faça alterações de configuração somente com a autorização adequada e um plano de rollback conhecido.
7. Teste novamente a mesma solicitação. Confirme o status, os cabeçalhos e o comportamento do cliente; depois, teste rotas e métodos relacionados para garantir que a correção não criou alterações indesejadas.

Prevenção e como verificar a correção

• Monitore as taxas de status HTTP por rota, método e implantação, em vez de tratar todas as respostas 2xx como equivalentes.
• Documente quais endpoints retornam 204 intencionalmente e como os clientes devem tratar uma resposta vazia bem-sucedida.
• Mantenha as regras de roteamento, autenticação, proxy, CDN, WAF e cache sob controle de versão.
• Teste URLs e métodos de API importantes após lançamentos da aplicação e da infraestrutura.
• Preserve contexto suficiente e sanitizado das solicitações e dos logs do servidor para correlacionar um status à camada responsável.
• Verifique se os clientes não tentam analisar um corpo quando uma rota foi projetada para retornar 204.

Perguntas frequentes