og:image이 표시되지 않나요? 해결 방법

og:image이 표시되지 않는 문제는 거의 항상 다섯 가지 원인 중 하나로 귀결됩니다: 이미지 URL이 공개되지 않음, 이미지가 너무 큼, 플랫폼이 이전 버전을 캐시함, 태그가 잘못된 페이지를 대상으로 함, 또는 이미지 형식이 지원되지 않음. 이 가이드는 Facebook, X, LinkedIn이 제공하는 디버깅 도구를 사용해 각 해결 방법을 안내합니다.

og:image이 표시되지 않는 이유는 무엇인가요?

대부분의 경우 이미지 URL이 공개적으로 접근 가능하지 않거나, 파일이 플랫폼의 제한을 초과하거나, 플랫폼이 캐시된 복사본을 표시하고 있기 때문입니다. 소셜 플랫폼은 일정에 따라 재스크래핑하고 적극적으로 캐시하므로, 새 이미지는 디버그 도구로 새로고침을 강제하기 전까지 "작동하지 않는" 것처럼 보이는 경우가 많습니다.

가장 흔한 다섯 가지 원인 (그리고 해결책)

1. 이미지 URL이 공개되어 있지 않음

플랫폼은 인증 없이 이미지를 가져와야 합니다. 로그인, localhost 또는 IP 주소 뒤에 있는 URL은 실패합니다.

해결책: 이미지를 공개 HTTPS URL에 호스팅하고 curl -I <image-url>이 이미지 Content-Type와 함께 200 OK을 반환하는지 확인하세요.

2. 이미지가 너무 큼

대부분의 플랫폼은 OG 이미지를 8 MB로 제한합니다(X는 약 5 MB). 큰 PNG는 조용히 실패합니다.

해결책: 파일을 5 MB 미만으로 유지하세요. 1200×630 텍스트 카드는 보통 200–500 KB입니다. FastOG에서는 PNG 출력이 이미 이에 맞게 크기가 조정됩니다.

3. 플랫폼이 이전 버전을 캐시함

Facebook, X, LinkedIn, Slack, Discord는 모두 적극적으로 캐시합니다. Meta는 또한 이미지의 자체 복사본을 저장하고 페이지 URL을 기준으로 미리보기를 키(key)로 사용하므로, 새 이미지 URL만으로는 변경되지 않습니다. 이미지를 변경한 후에도 이전 카드가 몇 시간 또는 며칠 동안 유지됩니다.

해결책: 플랫폼의 도구(아래 참조)로 스크레이핑을 강제하세요. 이미지를 변경하는 경우 콘텐츠에 따라 달라지는 URL을 사용하세요(FastOG의 서명된 URL이 자동으로 이 작업을 수행합니다). 프로그래밍 방식으로 새로고침을 허용하는 유일한 플랫폼은 Force a Facebook Open Graph Cache Refresh를 참조하세요.

4. 잘못된 URL 또는 잘못된 페이지

og:image 태그가 누락되었거나, 중복되었거나, 해당 태그가 없는 페이지를 가리킬 수 있습니다.

해결책: 페이지 소스를 확인하고 og:image 태그가 존재하고, 서버에서 렌더링되며, 절대 경로인지 확인하세요.

5. 지원되지 않는 형식

일부 플랫폼은 특정 형식이나 애니메이션 이미지를 거부합니다.

해결책: PNG 또는 JPG를 사용하세요. 1200×630이 지원되는 비율입니다.

디버깅 도구

플랫폼	도구
Facebook / WhatsApp	Sharing Debugger — `developers.facebook.com/tools/debug`
X / Twitter	Card Validator — `cards-dev.twitter.com/validator`
LinkedIn	Post Inspector — `linkedin.com/post-inspector`

URL을 붙여넣은 후 "Scrape" / "Refresh"를 눌러 최신 태그를 가져오세요.

FastOG 세부 사항

FastOG는 지원되는 크기인 1200×630 PNG를 렌더링하므로 크기/비율 문제를 피할 수 있습니다.
서명된 URL은 첫 번째 렌더링에만 적용되며, 캐시된 이미지는 유효한 상태로 유지되므로 공유된 카드는 계속 작동합니다.
제목을 변경하면 URL이 변경되고 새 렌더링이 하나 생성됩니다. 플랫폼은 강제로 다시 스크랩(re-scrape)하면 (결국) 새 카드를 인식합니다.

FAQ

FastOG가 제 og:image가 표시되는 것을 보장하나요?

FastOG는 공개 URL에서 유효한 1200×630 PNG를 제공합니다. 플랫폼에서 표시되는지 여부는 해당 플랫폼의 캐시에 따라 달라집니다 — 이미지를 변경한 후 검증 도구로 다시 스크래핑하세요.

Facebook에서 이미지를 업데이트했는데도 이전 이미지가 표시되는 이유는 무엇인가요?

Facebook은 스크래핑 결과를 캐시하고, 이미지 자체의 자체 사본을 유지합니다 — 따라서 새 og:image URL만으로는 변경되지 않습니다. Sharing Debugger → "Scrape Again"을 사용하세요. Force a Facebook Open Graph Cache Refresh에서 API 경로, 필요한 앱 토큰, 준수해야 할 속도 제한을 다룹니다.

X에서 새 카드가 표시되도록 하려면 어떻게 해야 하나요?

X Card Validator를 열고 URL을 붙여넣으세요. 최신 og:image 및 twitter:image을 다시 가져옵니다.