Imagens quebradas ou que não aparecem no site? Descubra o erro pelo navegador e corrija caminho, maiúsculas, permissões, hotlink e conteúdo misto.
Imagem que não aparece quase sempre tem uma causa que o próprio navegador mostra em segundos. Comece pelo diagnóstico e só depois vá para a correção.
Passo 1: descubra o erro da imagem
- Abra as ferramentas do navegador. Na página com problema, tecle
F12(no Mac,Cmd+Option+I) e abra a aba Rede (Network). - Filtre por imagens e recarregue. Clique em Img e recarregue a página.
- Leia o status da imagem quebrada (em vermelho):
- 404: o arquivo não está no endereço pedido (caminho, nome ou maiúsculas).
- 403: o servidor recusou (permissão ou proteção contra hotlink).
- blocked: mixed-content: imagem em
httpnuma páginahttps.
Atalho sem ferramentas: clique com o botão direito na imagem quebrada e abra-a numa nova guia. A mensagem de erro aparece direto.
Erro 404: caminho, nome ou maiúsculas
Maiúsculas e minúsculas fazem diferença
No servidor Linux, Banner.JPG e banner.jpg são arquivos diferentes. No Windows e no Mac não são, por isso o site funciona no seu computador e quebra depois de publicado. Padronize os nomes em minúsculas e use exatamente o mesmo nome no HTML.
Acentos, cedilha e espaços no nome
Renomeie Promoção de Natal.jpg para promocao-de-natal.jpg: sem acentos, sem cedilha, sem espaços, com hífen separando as palavras.
Caminho relativo errado
img/foto.jpg é procurado a partir da pasta da página atual, então funciona na página inicial e quebra numa subpasta. Prefira caminhos a partir da raiz, como /img/foto.jpg. Dentro de um arquivo CSS, o caminho relativo é contado a partir da pasta do CSS, não da página.
Imagens que sumiram depois de uma migração
No WordPress, confira se a pasta wp-content/uploads foi copiada inteira e se os endereços das imagens não apontam para o domínio antigo ou para o endereço provisório. Para trocar os endereços gravados nos posts, use um plugin de busca e substituição no banco, depois de um backup.
Erro 403: permissão ou hotlink
Permissões
Imagens precisam de permissão 644 e as pastas, 755. Arquivos extraídos de zip ou enviados por FTP às vezes chegam com 600 e ficam ilegíveis para o servidor. Corrija no Gerenciador de arquivos do cPanel, em Alterar permissões.
Proteção contra hotlink
Se a Proteção contra hotlink (Hotlink Protection) está ligada no cPanel, todas as formas do seu domínio precisam estar na lista de permitidos: com e sem www, com http e https. Faltando uma, as imagens dão 403 justamente nesse endereço.
Conteúdo misto: imagem http em página https
Com o site em HTTPS, o navegador bloqueia ou marca como inseguras as imagens chamadas por http://. A aba Console mostra o aviso "Mixed Content". Troque os endereços para https:// ou para caminhos a partir da raiz (/img/foto.jpg). No WordPress, faça a troca de http://seudominio.com.br por https://seudominio.com.br com um plugin de busca e substituição.
Outras causas
- Plugins de otimização e lazy load. Conversão para WebP, carregamento preguiçoso e CDN de imagens podem falhar. Desative um de cada vez, limpe o cache do plugin e teste.
- Imagem trocada que continua a antiga. É cache: renomeie o arquivo ou acrescente
?v=2no endereço. Veja o artigo sobre alteração que não aparece. - Formato HEIC. Fotos de iPhone em HEIC não abrem na maioria dos navegadores. Converta para JPG ou WebP antes de enviar.
- Extensão que não bate com o arquivo. Um PNG renomeado para
.jpgpode não carregar. Exporte de novo no formato certo.