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.

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
- Por que 404 não significa que o arquivo sumiu
- As duas linhas de log que resolvem a maior parte dos casos
- Quando o domínio responde em uma pasta e o arquivo está em outra
- Quando a reescrita captura a URL antes de o arquivo ser aberto
- Permissão gera 403, e só se disfarça de 404 em dois casos
- Da tabela de sintomas à prova que fecha o diagnóstico
- Quando não é document root, reescrita nem permissão
- Checklist de quinze minutos para rodar em carteira de sites
- 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:
- Descobre qual virtual host atende aquele
Host:e qual é o document root dele. - Aplica as regras de reescrita (
.htaccess, configuração do vhost, plugins que geram regras). - 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.
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
- Domínio adicional criado com document root dentro de
public_html/, e o cliente subindo arquivos na raiz da conta. - Site migrado que ficou com a pasta antiga no disco, enquanto o vhost já aponta para a nova.
wp-content/uploadsmovido ou comWP_CONTENT_URLdivergente do caminho físico, o que gera 404 só em imagem e anexo, com o HTML abrindo normalmente.
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:
- Sem
.htaccess, os permalinks param de funcionar enquanto o teste dura. Faça fora do horário de pico e devolva o arquivo imediatamente. - Plugin de segurança e de cache pode reescrever o
.htaccesssozinho. Se ao renomear aparecer um novo, alguém está gerando o arquivo, e é ali que você vai olhar. - Cache de página (LSCache, plugin de cache, CDN) pode devolver o 404 antigo já armazenado. Purgue o cache antes de concluir qualquer coisa, e prefira testar com uma URL nova, que ainda não tenha sido cacheada.
Onde a regra de reescrita costuma estar escondida
- Bloco do WordPress em
.htaccesssem a linhaRewriteCond %{REQUEST_FILENAME} !-f, que é justamente a condição que diz "se o arquivo existir, não reescreva". - Plugin de redirecionamento com regra curinga em cima de uma pasta inteira.
.htaccessdentro de uma subpasta, que sobrepõe o da raiz. Muita gente olha só o da raiz e conclui que não há reescrita. Confira o caminho inteiro:
find ~/public_html -name .htaccess
- Regra de bloqueio por extensão, comum em endurecimento de segurança, que devolve 404 para
.pdf,.zipou.sqlde propósito.
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 |
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.
- 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. - Confirme que a requisição aparece no access log do domínio. Se não aparece, o problema é de roteamento, não de arquivo.
- Liste o document root de todos os domínios, subdomínios e aliases da conta. Guarde essa lista na documentação do cliente.
- Rode o teste do arquivo canário nas pastas candidatas. Apague os canários no fim.
- Procure todos os
.htaccessda conta comfind, não só o da raiz. - Renomeie o
.htaccessda raiz por trinta segundos e repita ocurl -I. Devolva o nome original antes de sair do terminal. - Purgue o cache do servidor e da CDN, e revalide com uma URL que nunca foi requisitada.
- Se o código for 403, vá direto ao error log e rode
namei -lno caminho completo do arquivo. - Varra permissões com os dois
findde diretório e arquivo, e corrija só o que destoar de 755 e 644. - 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:
- Reescrita: "Uma regra de redirecionamento do site está interceptando esse endereço antes de o servidor chegar ao arquivo. Vou liberar a exceção para esse tipo de arquivo."
- Permissão: "O arquivo está lá, mas uma das pastas do caminho está fechada para leitura pública. Ajusto a permissão dessa pasta e o acesso volta."
- DNS ou cache: "O arquivo já está publicado. O que você está vendo é uma versão guardada em cache. Vou limpar e te mando a URL para conferir."
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
- Documentação oficial (litespeed) — 404 Error. Consultado em 2026-09-17.