401 Não autorizado

O HTTP 401 Não autorizado significa que é preciso enviar credenciais válidas antes de o servidor devolver o recurso solicitado, por isso rastreadores públicos não conseguem acessá-lo.

O que uma resposta 401 significa

Uma resposta 401 Não autorizado diz que o servidor não vai entregar o recurso solicitado até que o cliente apresente credenciais de autenticação aceitáveis. O nome é histórico: o status trata de autenticação ausente ou falha, e não de um julgamento de que quem pede não tem permissão. Uma resposta correta normalmente inclui um desafio WWW-Authenticate que identifica o esquema de autenticação.

Para uma área de membros, um endpoint de API, um link de pré-visualização ou um documento privado, o 401 pode ser a fronteira correta. Ele vira um defeito de SEO quando uma URL destinada a visitantes comuns — ou uma requisição de CSS, JavaScript, imagem ou dados necessária para renderizar essa URL pública — retorna 401. Um rastreador de busca não consegue fazer login como um membro comum, então não consegue obter de forma confiável a resposta protegida.

Ilustração conceitual: uma resposta 401 é uma fronteira de autenticação, não uma evidência de que a página pública está indisponível para todas as pessoas.
Não reclassifique uma exigência de login deliberada como problema de SEO. Primeiro classifique a URL e cada recurso necessário para a renderização como público, autenticado ou intencionalmente indisponível.

Defina o que deve ser público

Comece pela função da página. Um produto, artigo, categoria, página de ajuda ou landing page pública precisa poder ser acessado sem sessão. Páginas de conta, faturas e pré-visualizações privadas devem exigir autenticação e não devem aparecer na navegação pública nem nos sitemaps. Essa classificação evita um erro comum: enfraquecer o controle de acesso só para que uma ferramenta de monitoramento mostre 200.

RespostaSignificadoAção típica
401As credenciais são exigidas ou rejeitadasMantenha para recursos privados; remova o desafio das rotas públicas previstas.
403O servidor entende a requisição, mas a recusaRevise as regras de autorização e de bots; não trate como pedido de login.
404Nenhum recurso atual é encontradoRetorne para URLs aposentadas ou desconhecidas, a menos que exista um substituto relevante.

Uma página pode ser pública enquanto parte do seu fluxo é privada. Por exemplo, deixe a página de produto e as imagens dela carregarem de forma anônima e peça login só quando o usuário abrir a área da conta. Mantenha o HTML público autossuficiente o bastante para que a primeira visita não dependa de uma requisição de API autenticada.

Inspecione o caminho da resposta

Teste uma URL principal sem cookies do navegador e registre o status final, a cadeia de redirecionamentos e os cabeçalhos de resposta. Depois, inspecione as requisições de rede da página para encontrar 401s em recursos essenciais à renderização. Uma barreira de login adicionada por CDN, proxy reverso, middleware da aplicação ou uma API upstream pode afetar caminhos diferentes, então uma única requisição bem-sucedida da página inicial não é evidência suficiente.

1Reproduza de forma anônima

Faça a requisição da URL exata em uma sessão limpa e capture o status final e o cabeçalho WWW-Authenticate.

2Localize a fronteira

Compare uma rota pública que funciona com a rota que recebe o desafio, incluindo redirecionamentos e recursos necessários.

3Aplique a correção mínima

Altere apenas a rota ou a regra de middleware que classifica incorretamente o recurso público.

4Teste os dois lados

Confirme que a rota pública responde sem autenticação, enquanto uma rota deliberadamente privada continua exigindo login.

A verificação prática tem dois lados. Se uma página pública passou a exigir autenticação, corrija a regra de acesso e teste a página renderizada de novo. Se uma página protegida ficou pública por engano, restaure a fronteira e confira se ela saiu dos links internos, dos feeds e dos sitemaps XML. Códigos de status descrevem o comportamento; eles não substituem um inventário de rotas.

Verifique a correção

Depois da implantação, rastreie de novo uma pequena amostra de templates como um visitante anônimo. Confira o HTML final e os recursos que carregam o conteúdo principal: estilos, scripts, imagens e dados estruturados. No Google Search Console, a Inspeção de URL pode ajudar a distinguir um problema atual de obtenção de um relatório de indexação antigo, mas não substitui a verificação da resposta ativa feita por você mesmo.

Use uma lista explícita de rotas públicas e autenticadas antes de considerar esse tipo de problema resolvido. O resultado útil não é um 200 universal: é uma fronteira consistente, em que as páginas públicas previstas respondem normalmente e as páginas privadas previstas continuam protegidas.

Inclua recursos protegidos e APIs na amostra de verificação. Uma página pública pode retornar 200 enquanto a requisição do conteúdo principal, da folha de estilos ou de uma imagem recebe 401 e deixa a experiência renderizada incompleta. Confira o status final e o desafio de autenticação de cada requisição essencial à renderização e teste de novo depois de mudar a regra de acesso.

Monitore o status por classe de URL, e não por um total sem distinção. Um artigo público que retorna 401 pede uma investigação diferente de um endpoint de conta que rejeita corretamente toda requisição anônima. Registre a amostra, o horário, o estado de quem faz a requisição e a URL final de cada problema, para que uma mudança futura possa ser verificada na mesma condição.

FAQ

O HTTP 401 significa que uma página está permanentemente indisponível?
Não. Significa que a requisição atual não trouxe uma autenticação aceitável. O recurso pode ficar disponível logo após um login válido, mas não pode ser obtido publicamente nesse estado da resposta.
Uma resposta 401 é o mesmo que 403 Forbidden?
Não. Uma resposta 401 pede autenticação; uma resposta 403 significa que o servidor recusa a requisição, mesmo tendo entendido o que foi pedido. A correção depende dessa diferença.
Uma página que retorna 401 deve estar no sitemap XML?
Não. O sitemap deve listar as URLs canônicas públicas que você quer que os buscadores rastreiem e considerem para indexação. Uma URL protegida por credenciais não cumpre essa função.
Como testar um 401 suspeito que pode ter sido acidental?
Faça a requisição da URL exata em uma sessão limpa, sem login; registre redirecionamentos e cabeçalhos; depois inspecione a página renderizada para ver se há requisições dependentes que também retornam 401.