페이지를 배포하고 링크를 공유했는데, 미리보기에 엉뚱한 이미지가 뜨거나 아예 아무것도 표시되지 않습니다. OG image 문제는 거의 대부분 다음 세 가지 중 하나입니다. 태그 누락, 깨진 이미지 URL, 오래된 캐시. 이 가이드에서는 공유 전에 OG image를 미리 확인하는 방법과 각 문제가 발생했을 때 해결하는 방법을 소개합니다.
먼저 태그부터 확인하세요
어떤 도구를 쓰기 전에, 페이지 소스를 열어(Ctrl+U / Cmd+U) <head> 안에 다음 태그들이 있는지 확인하세요:
<meta property="og:title" content="Launch day: v2.0" />
<meta property="og:description" content="Everything new in this release." />
<meta property="og:image" content="https://example.com/og/launch.png" />
<meta property="og:image:width" content="1200" />
<meta property="og:image:height" content="630" />
<meta name="twitter:card" content="summary_large_image" />다음 두 가지 규칙만 지켜도 대부분의 버그를 바로 잡아낼 수 있습니다:
og:image는 반드시 절대 HTTPS URL이어야 합니다. 상대 경로(/og/launch.png)는 대부분의 크롤러에서 실패합니다.- 이미지 URL은 누구나 접근 가능해야 합니다. 시크릿 창에서 직접 열어 보세요. 로그인이 필요하거나, 리디렉션되거나, 404가 뜬다면 어떤 플랫폼도 이미지를 가져올 수 없습니다.
이미지 크기가 맞는지조차 확실하지 않다면 OG image 사이즈 가이드부터 확인하세요. 올바른 크기는 미리보기가 제대로 동작하기 위한 나머지 절반입니다.
플랫폼별 미리보기 도구
주요 플랫폼은 크롤러가 보는 화면을 그대로 보여 주는 공식 디버거를 제공합니다:
| 플랫폼 | 도구 | 기능 |
|---|---|---|
| Sharing Debugger | 스크랩된 카드를 보여 주고, 경고 목록과 "Scrape Again" 버튼을 제공합니다 | |
| Post Inspector | 미리보기를 렌더링하고, 검사할 때마다 LinkedIn의 캐시를 갱신합니다 | |
| X (Twitter) | 게시물 초안 작성 | X는 독립형 Card Validator 미리보기를 없앴습니다. 링크를 초안에 붙여 넣거나 자신에게 DM으로 보내면 실제 카드를 확인할 수 있습니다 |
| Slack | 나에게 메시지 보내기 | Slack은 실시간으로 미리보기를 펼칩니다. 자신에게 보내는 DM이 가장 빠른 OG 미리보기 방법입니다 |
| Discord | 아무 채널에나 붙여넣기 | Open Graph 태그를 기반으로 임베드가 즉시 렌더링됩니다 |
| WhatsApp / Telegram | "Saved messages"(저장된 메시지) 또는 나에게 보내기 | 둘 다 og:image를 읽습니다. Telegram은 캐시를 매우 오래 유지합니다(아래 참고) |
실용적인 작업 순서는 이렇습니다. 태그를 고친다 → Facebook Sharing Debugger를 돌린다(경고가 가장 상세합니다) → 실제로 중요한 플랫폼에서 최종 확인한다.
캐시 강제 갱신하기
플랫폼은 링크 미리보기를 매우 오래, 때로는 몇 주씩 캐시합니다. OG image를 업데이트했는데 계속 예전 이미지가 보인다면:
- Facebook: Sharing Debugger를 열고 Scrape Again을 클릭하세요.
- LinkedIn: URL을 Post Inspector에 넣어 검사하세요. 검사 자체가 캐시를 무효화합니다.
- X: 수동 갱신 방법이 없습니다. 캐시는 보통 일주일 안에 만료됩니다.
- Telegram:
@WebpageBot에게 URL을 보내면 강제로 다시 크롤링합니다. - 만능 해결책: 이미지 URL을 바꾸는 것입니다. 버전 쿼리를 붙이거나(
/og/launch.png?v=2), 더 좋게는 콘텐츠 해시 파일명을 사용하면 모든 플랫폼이 즉시 완전히 새로운 이미지로 취급합니다.
OG image를 파이프라인으로 생성한다면 처음부터 파일명에 버전이나 해시를 넣어 두세요. 캐시 무효화 문제가 아예 사라집니다.
그래도 OG image가 표시되지 않는 이유
디버거를 다 돌렸는데도 이미지가 안 보인다면, 아래 목록을 순서대로 점검하세요:
- 이미지가 너무 크거나 너무 느립니다. 크롤러는 수 메가바이트짜리 파일에서 타임아웃됩니다. 1 MB 미만(WhatsApp은 300 KB보다 훨씬 작게)으로 유지하세요.
- 이미지 크기가 큰 카드 기준에 미달합니다. 600×315 미만이면 Facebook은 작은 썸네일로 대체합니다. 1200×630으로 내보내세요. 자세한 내용은 사이즈 가이드에 있습니다.
- 페이지가 크롤러를 차단하고 있습니다.
robots.txt, 방화벽, 봇 차단 레이어가facebookexternalhit,Twitterbot,LinkedInBot에 403을 반환하고 있지 않은지 확인하세요. - 태그가 클라이언트 사이드에서 주입됩니다. 대부분의 소셜 크롤러는 JavaScript를 실행하지 않습니다. OG 태그는 서버에서 렌더링된 HTML에 있어야 합니다.
- 여러 개의
og:image태그가 충돌합니다. 플랫폼은 보통 첫 번째 태그를 사용합니다. 템플릿이나 플러그인이 남긴 태그를 제거하세요.
게시 후가 아니라 게시 전에 미리 보세요
위의 디버거들은 문제가 생긴 뒤에야 원인을 알려 줍니다. 더 저렴한 습관은 배포 전에 이미지를 제대로 만드는 것입니다. 저희 무료 OG image 생성기는 편집하는 동안 정확한 1200×630 크기로 실시간 미리보기를 보여 주고(에디터에서 보이는 그대로가 픽셀 단위로 카드에 표시됩니다), 이 글의 모든 점검 항목을 통과하는 최적화된 PNG를 내보냅니다. 회원가입도, 워터마크도 없습니다.
자주 묻는 질문
게시하지 않고 OG image를 미리 보려면 어떻게 하나요?
공식 렌더링을 보려면 Facebook Sharing Debugger나 LinkedIn Post Inspector를 사용하고, 또는 Slack, Discord, WhatsApp에서 자신에게 링크를 보내 보세요. 나에게 보내는 메시지도 공개 공유와 똑같이 미리보기가 펼쳐집니다.
OG image 캐시는 얼마나 오래 유지되나요?
플랫폼마다 다릅니다. Facebook은 강제로 다시 스크랩할 때까지 캐시를 유지하고, LinkedIn은 Post Inspector로 갱신되며, X는 보통 일주일 안에 자동 만료됩니다. 이미지 URL을 바꾸면(?v=2 또는 새 파일명) 모든 캐시를 한 번에 우회할 수 있습니다.
왜 OG image가 Facebook에는 보이는데 WhatsApp에는 안 보이나요?
거의 항상 파일 용량 문제입니다. WhatsApp은 무거운 이미지를 포기해 버립니다. PNG를 압축하거나 더 작은 버전을 제공해서 300 KB보다 훨씬 작게 유지하세요.
JavaScript로 렌더링되는 페이지에서도 OG 태그가 작동하나요?
태그가 최초 서버 응답에 포함되어 있을 때만 작동합니다. 소셜 크롤러는 일반적으로 JavaScript를 실행하지 않으므로, 클라이언트 사이드에서 주입된 메타 태그는 크롤러에게 보이지 않습니다.
