# 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.

> 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.

João Rizzon · 2026-09-20 · Infraestrutura web

---

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](https://docs.litespeedtech.com/lsws/cp/cpanel/404-error/) 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/uploads` movido ou com `WP_CONTENT_URL` divergente 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 `.htaccess` sozinho. 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 `.htaccess` sem a linha `RewriteCond %{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.
- `.htaccess` dentro 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`, `.zip` ou `.sql` de 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 `.htaccess` da conta com `find`, não só o da raiz.
- Renomeie o `.htaccess` da raiz por trinta segundos e repita o `curl -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 -l` no caminho completo do arquivo.
- Varra permissões com os dois `find` de 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:

> **** O arquivo está no servidor, eu estou vendo ele aqui. O problema é que o endereço que você digitou leva o servidor a procurar em outra pasta, e nessa pasta o arquivo realmente não está. É como uma encomenda entregue no apartamento 302 quando o endereço do pedido dizia 203: a encomenda existe, só não está onde estão procurando. Estou ajustando o caminho para que o endereço aponte para a pasta certa.

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.

