og:image quebrada — Sua imagem para redes sociais não está carregando

Qual é o problema?

Sua página tem uma meta tag og:image, mas a URL para a qual ela aponta não retorna uma imagem válida. Isso significa que a imagem está efetivamente quebrada — as plataformas sociais mostrarão um placeholder, um ícone de imagem quebrada ou nenhuma imagem quando o seu link for compartilhado.

Isso é pior do que não ter og:image nenhuma, porque sinaliza para as plataformas e para os usuários que algo está errado no seu site.

Causas comuns

1. URL errada ou erro de digitação

A URL da imagem na meta tag não corresponde a um arquivo real no seu servidor.

2. O servidor retorna um erro (404, 500, etc.)

O arquivo de imagem foi excluído, movido ou o servidor está mal configurado.

3. Tipo de conteúdo que não é imagem

A URL existe, mas retorna HTML (por exemplo, uma página de login ou de erro) em vez de um arquivo de imagem de verdade. O servidor deve retornar um cabeçalho Content-Type que comece com image/ (por exemplo, image/jpeg, image/png).

4. Redirecionamento para um recurso que não é imagem

A URL da imagem redireciona para uma página que não é uma imagem (por exemplo, uma página de login de CDN ou um link expirado).

5. Restrições de acesso

A imagem exige autenticação, está atrás de um firewall ou está bloqueada para requisições externas (por exemplo, proteção contra hotlinking).

6. URL relativa sem base adequada

Usar um caminho relativo como /images/og.jpg sem uma resolução de URL adequada pode gerar referências quebradas.

Como corrigir

Passo 1: Verifique a URL da imagem

Abra a URL de og:image diretamente no navegador. Ela deve exibir a imagem — não uma página de erro nem um redirecionamento.

Passo 2: Confira o tipo de conteúdo

O servidor deve responder com um tipo de conteúdo de imagem:

Content-Type: image/jpeg
Content-Type: image/png
Content-Type: image/webp
Content-Type: image/gif

Passo 3: Use uma URL absoluta com HTTPS

Sempre use uma URL completa e absoluta:

<!-- Ruim -->
<meta property="og:image" content="/images/og.jpg" />

<!-- Bom -->
<meta property="og:image" content="https://yoursite.com/images/og.jpg" />

Passo 4: Garanta acesso público

A imagem deve ser acessível publicamente, sem autenticação. Os crawlers de redes sociais não conseguem fazer login para buscar a sua imagem.

Passo 5: Teste com curl

Você pode verificar pela linha de comando:

curl -I https://yoursite.com/og-image.jpg

Procure por HTTP/2 200 e content-type: image/... na resposta.

Impacto no compartilhamento social

Uma og:image quebrada é um dos problemas mais prejudiciais para a presença em redes sociais:

• Facebook — Mostra um placeholder cinza ou nenhuma imagem
• Twitter/X — Cai em um card só de texto, com engajamento mínimo
• LinkedIn — Exibe uma pré-visualização vazia, com aparência pouco profissional
• Discord, Slack, Telegram — Mostram embeds de imagem quebrados ou ausentes
• WhatsApp — Mostra um link sem nenhuma pré-visualização visual

Links com imagens quebradas podem receber até 80% menos engajamento em comparação com links com imagens funcionando.

Dicas de prevenção

1. Automatize a validação de imagens — Adicione uma verificação no seu pipeline de CI/CD que confira se as URLs de og:image retornam imagens válidas
2. Use um CDN — CDNs como Cloudinary, Imgix ou Cloudflare Images garantem entrega confiável de imagens
3. Monitore suas imagens — Configure monitoramento de disponibilidade para as URLs de imagem críticas
4. Use imagens de fallback — Configure o servidor para retornar uma imagem OG padrão se a específica estiver ausente
5. Versionamento de imagens — Inclua um hash ou versão no nome do arquivo para evitar problemas de cache