blog
Infraestrutura web

404 com o arquivo na pasta: 3 causas e como provar cada uma

Document root, reescrita e permissão produzem o mesmo sintoma e exigem correções diferentes. Access log, error log e um arquivo canário separam as três em minutos, sem reinstalar nada.

JR · · 12 min de leitura · 1 tabela · 11 blocos de código

Resposta curta: quando o arquivo está na pasta e a URL devolve 404, as causas são três: document root em outro diretório, reescrita que capturou a URL antes do arquivo, e permissão no caminho (que vira 403). O access log separa as duas primeiras, o error log confirma a terceira e um arquivo canário prova o document root.

Neste artigo
  1. Por que 404 não significa que o arquivo sumiu
  2. As duas linhas de log que resolvem a maior parte dos casos
  3. Quando o domínio responde em uma pasta e o arquivo está em outra
  4. Quando a reescrita captura a URL antes de o arquivo ser aberto
  5. Permissão gera 403, e só se disfarça de 404 em dois casos
  6. Da tabela de sintomas à prova que fecha o diagnóstico
  7. Quando não é document root, reescrita nem permissão
  8. Checklist de quinze minutos para rodar em carteira de sites
  9. Como explicar ao cliente que está vendo o arquivo na tela

O arquivo está no gerenciador. Você abre a pasta, vê relatorio.pdf com 412 KB e data de ontem. Acessa a URL e o navegador devolve 404. A tentação é reenviar o arquivo, trocar o nome, reinstalar o WordPress ou abrir chamado pedindo "reset do servidor". Nenhuma dessas ações diagnostica nada.

Um 404 não significa "o arquivo não existe". Significa "o servidor resolveu a URL para um caminho e não achou nada lá". São afirmações diferentes, e a distância entre as duas é exatamente onde mora o problema. Este guia separa as três causas que produzem esse sintoma e mostra como provar cada uma, sem tocar no conteúdo do site.

Por que 404 não significa que o arquivo sumiu

Quando uma requisição chega, o servidor web faz três coisas em sequência, nesta ordem:

  1. Descobre qual virtual host atende aquele Host: e qual é o document root dele.
  2. Aplica as regras de reescrita (.htaccess, configuração do vhost, plugins que geram regras).
  3. Tenta abrir o arquivo no caminho final resultante.

O 404 nasce no passo 3, mas a causa quase sempre está nos passos 1 ou 2. O gerenciador de arquivos do painel te mostra o disco. O servidor te mostra o resultado de uma resolução de caminho. Quando os dois discordam, é porque a resolução leva a outro lugar.

A documentação oficial do LiteSpeed sobre erro 404 em cPanel trata o assunto nessa chave: 404 como sintoma de configuração de virtual host e de reescrita, com checagem no log do servidor, e não como arquivo ausente do disco.

Uma das três causas, a permissão, quase nunca produz 404. Produz 403 ou uma entrada no error log, e por isso exige um log diferente das outras duas. Voltamos nisso.

O caminho que a requisição percorre antes do 404Vhost e document rootServidor escolhe a pasta baseRegras de reescrita.htaccess, vhost, pluginsAbertura do arquivoAqui nasce o 404
O 404 aparece no passo 3, mas a causa costuma estar nos passos 1 e 2.

As duas linhas de log que resolvem a maior parte dos casos

Duas linhas de log respondem a maior parte dos casos. Em conta cPanel, os logs de acesso do domínio ficam acessíveis pelo diretório de logs da conta (costuma existir um atalho ~/access-logs/) e pela interface de logs brutos do painel. O error log aparece na interface de erros, que mostra as últimas entradas registradas.

Com acesso SSH, filtrar por código é suficiente para começar:

tail -n 200 ~/access-logs/exemplo.com.br | grep ' 404 '

Exemplo ilustrativo de linha de acesso (dados fictícios):

203.0.113.9 - - [17/Sep/2026:10:02:11 -0300] "GET /relatorio.pdf HTTP/2.0" 404 209 "-" "Mozilla/5.0"

O que essa linha prova: a requisição chegou neste servidor, neste vhost, e terminou em 404 com resposta de 209 bytes. O tamanho da resposta é uma pista de triagem, não um veredito. Resposta de dezenas de kilobytes indica que alguma aplicação gerou a página, quase sempre o próprio WordPress com o tema carregado, o que aponta para reescrita. Resposta minúscula indica página de erro padrão do servidor, mas isso também acontece quando uma regra de bloqueio por extensão devolve 404 de propósito e quando um plugin de segurança responde 404 em acesso negado. Ou seja: resposta pequena reduz o campo, e quem fecha o diagnóstico é o arquivo canário (causa 1) e o teste do .htaccess (causa 2). A causa 3 não se resolve aqui: ela aparece no error log.

Se a requisição não aparece em nenhum access log do servidor, pare. O problema não é o arquivo: o tráfego está indo para outro lugar (DNS antigo, CDN, proxy, ambiente de homologação). Tratamos disso na última seção.

Quando o domínio responde em uma pasta e o arquivo está em outra

É a causa mais comum em conta com vários domínios. Domínio adicional, subdomínio, alias e a pasta que o cliente usa não são a mesma coisa. O cliente envia o arquivo para public_html/, mas o domínio dele responde em public_html/loja/ ou em /home/usuario/lojaexemplo.com.br/. O arquivo existe, o servidor procura em outro endereço, e o 404 é tecnicamente correto.

Como confirmar o document root de cada domínio da conta

No cPanel, a lista de domínios mostra o document root de cada entrada, incluindo aliases e subdomínios. Anote todos antes de mexer em qualquer coisa. Duas situações que a lista revela e que o gerenciador de arquivos esconde: uma mesma pasta pode atender mais de um domínio, e diretórios órfãos de migração antiga podem continuar no disco depois que o vhost já aponta para outro lugar.

O arquivo canário que encerra a dúvida em trinta segundos

Em vez de deduzir, meça. Crie um arquivo com nome único em cada pasta candidata e peça as duas URLs:

echo "pasta A" > ~/public_html/canario-a.txt
echo "pasta B" > ~/public_html/loja/canario-b.txt

Acesse https://exemplo.com.br/canario-a.txt e https://exemplo.com.br/canario-b.txt. A que responder 200 é o document root real daquele domínio. Leva trinta segundos e encerra a discussão.

Alternativa com PHP, útil quando o site tem várias pastas aninhadas e você quer o caminho absoluto impresso:

<?php echo $_SERVER['DOCUMENT_ROOT'];

Salve como raiz.php na pasta que você acha que é a raiz, acesse pelo navegador e compare com o caminho que o gerenciador de arquivos mostra na barra superior. Apague os arquivos de teste depois.

Os três desalinhamentos de pasta mais comuns

Quando a reescrita captura a URL antes de o arquivo ser aberto

Aqui o document root está certo, o arquivo está na pasta certa, e mesmo assim o servidor devolve 404. O que acontece é que uma regra de reescrita capturou a URL e mandou para index.php antes que a tentativa de abrir o arquivo acontecesse. O WordPress recebeu uma URL que não corresponde a nenhum post e cumpriu o protocolo: respondeu 404, com o tema, o menu e o campo de busca.

O sinal mais barato é o que a página mostra. Página bonita com o logo do cliente: quem respondeu 404 foi a aplicação, e o arquivo nunca foi consultado no disco. Página de erro genérica com poucos bytes empurra a suspeita para o document root, mas não elimina a reescrita, porque regra de bloqueio por extensão também devolve o 404 padrão do servidor. Por isso o teste abaixo continua valendo mesmo quando a página é genérica.

Renomear o .htaccess por trinta segundos prova a reescrita

O teste definitivo é tirar as regras do caminho por trinta segundos:

cd ~/public_html
mv .htaccess .htaccess.teste
curl -I https://exemplo.com.br/relatorio.pdf
mv .htaccess.teste .htaccess

Se o curl -I voltar 200 sem o .htaccess e 404 com ele, a causa está provada e você nem precisou ler as regras linha a linha. Três cuidados antes de rodar isso em site de cliente:

Onde a regra de reescrita costuma estar escondida

find ~/public_html -name .htaccess

Permissão gera 403, e só se disfarça de 404 em dois casos

Esta é a inversão útil do artigo. Quando o servidor encontra o arquivo mas não consegue lê-lo, a resposta padrão é 403 Forbidden, não 404. E o motivo costuma ficar registrado no error log, não no access log.

Exemplo ilustrativo de entrada de error log em Apache (dados fictícios), que explicita o ponto mais esquecido:

[Wed Sep 17 10:02:11 2026] [core:error] [pid 1234] (13)Permission denied:
[client 203.0.113.9] access to /relatorio.pdf denied because search permissions
are missing on a component of the path

"Um componente do caminho" é a chave. Não adianta o arquivo estar 644 se a pasta uploads está 700 ou se um diretório intermediário ficou com dono errado depois de um unzip feito com outro usuário. O servidor precisa de permissão de execução em todos os diretórios do caminho, da raiz da conta até a pasta final.

Valide o caminho inteiro de uma vez:

namei -l /home/exemplo/public_html/wp-content/uploads/2026/09/relatorio.pdf

O namei -l imprime uma linha por componente, com permissão, dono e grupo. Você vê na hora qual pasta está fora do padrão. Varredura em lote para achar o que destoa:

find ~/public_html -type d ! -perm -o=rx -print
find ~/public_html -type f ! -perm -o=r -print

O primeiro lista diretórios sem leitura e execução para outros. O segundo lista arquivos sem leitura para outros. Em hospedagem compartilhada com usuário próprio por conta, o padrão seguro é 755 para diretório e 644 para arquivo, e o que aparecer nessas duas listas merece explicação.

Dois casos em que a permissão se disfarça de 404: quando o vhost tem uma página de erro personalizada que responde o mesmo conteúdo para 403 e 404, e quando um plugin de segurança devolve 404 deliberadamente em acesso negado, para não confirmar ao atacante que o recurso existe. Nos dois, o error log continua contando a verdade.

Da tabela de sintomas à prova que fecha o diagnóstico

Sintoma observado Causa provável Prova
404 com página genérica e resposta de poucos bytes Document root errado, arquivo fora da raiz do vhost ou bloqueio por extensão Arquivo canário responde 200 em uma pasta e 404 na outra; se o canário confirmar a raiz, testar o .htaccess
404 com o tema do site carregado Reescrita mandou a URL para index.php curl -I volta 200 com o .htaccess renomeado
404 só em imagem e anexo, HTML normal Caminho de uploads divergente do físico namei -l no caminho do anexo e conferência do document root
403 Forbidden Permissão ou dono em algum componente do caminho Entrada de Permission denied no error log
A requisição não aparece em nenhum access log Tráfego não chega neste servidor Comparar IP do dig com o IP da conta
404 que persiste depois da correção Cache de página ou CDN servindo a resposta antiga Testar URL nova, nunca requisitada, e purgar cache
Ordem de eliminação para fechar o diagnósticoA requisição aparece no access log?Se não, é roteamento: DNS, CDN, homologaçãoArquivo canário responde 200?Prova qual pasta é o document root realcurl volta 200 sem .htaccess?Reescrita capturou a URLO código é 403?Error log e namei -l no caminhoPersiste após corrigir?Purgue cache e teste URL nova
Cada pergunta elimina uma hipótese antes da próxima. Siga a ordem.

Quando não é document root, reescrita nem permissão

Antes de virar a noite em cima do .htaccess, descarte o cenário mais banal: o arquivo está no servidor certo, mas o visitante está em outro.

dig +short exemplo.com.br
curl -I https://exemplo.com.br/relatorio.pdf

Se o IP retornado pelo dig não é o IP da conta de hospedagem, o site que você está corrigindo não é o site que o cliente está vendo. Acontece com DNS apontado para servidor antigo depois de migração, com proxy de CDN na frente e com ambiente de homologação que o cliente acessa sem perceber.

Outra armadilha: maiúsculas e minúsculas. Linux distingue Relatorio.PDF de relatorio.pdf, Windows não. Arquivo enviado do desktop com nome capitalizado e link escrito em minúsculas gera 404 com o arquivo bem visível no gerenciador. Confira com ls em vez de confiar na leitura visual:

ls -la ~/public_html | grep -i relatorio

Espaço no fim do nome e acento também entram nessa lista. O ls -la mostra o nome exato armazenado.

Checklist de quinze minutos para rodar em carteira de sites

Este é o roteiro que cabe em um atendimento de quinze minutos e que você repete em qualquer conta. A ordem importa: cada passo elimina uma hipótese antes do próximo.

  1. Reproduza e capture o código real com curl -I. Anote o status e o tamanho da resposta. Não confie no print do cliente, que pode estar em cache do navegador.
  2. Confirme que a requisição aparece no access log do domínio. Se não aparece, o problema é de roteamento, não de arquivo.
  3. Liste o document root de todos os domínios, subdomínios e aliases da conta. Guarde essa lista na documentação do cliente.
  4. Rode o teste do arquivo canário nas pastas candidatas. Apague os canários no fim.
  5. Procure todos os .htaccess da conta com find, não só o da raiz.
  6. Renomeie o .htaccess da raiz por trinta segundos e repita o curl -I. Devolva o nome original antes de sair do terminal.
  7. Purgue o cache do servidor e da CDN, e revalide com uma URL que nunca foi requisitada.
  8. Se o código for 403, vá direto ao error log e rode namei -l no caminho completo do arquivo.
  9. Varra permissões com os dois find de diretório e arquivo, e corrija só o que destoar de 755 e 644.
  10. Registre no histórico do cliente qual das causas era, com a linha de log que provou.

Padronizar dois desses passos em todas as contas que você administra transforma o 404 de urgência em tarefa de rotina: o levantamento dos document roots e o find que localiza todos os .htaccess. Com a lista de document roots atualizada por cliente, o diagnóstico da próxima vez já começa direto nela, e metade das consultas que este artigo descreve deixa de existir.

Como explicar ao cliente que está vendo o arquivo na tela

O cliente está olhando o arquivo na tela e ouvindo que ele não existe. Do ponto de vista dele, você está errado. Vale explicar pela analogia do endereço, não pelo protocolo:

Variações conforme a causa confirmada:

O que essas frases têm em comum é não prometer o que você ainda não provou. Diga a causa depois de ver a linha de log que a sustenta, nunca antes.

Referências

  1. Documentação oficial (litespeed) — 404 Error. Consultado em 2026-09-17.
Leia também