가이드
공유 링크에서 미리보기 이미지가 안 나올 때 해결 방법
OG 메타데이터, 이미지 접근성, 캐시를 순서대로 점검해 미리보기 이미지 누락 문제를 빠르게 해결하세요.
공유 링크에 이미지가 보이지 않는 문제는 대부분 태그 누락, URL 접근 제한, 캐시 이슈로 설명됩니다. 점검 순서만 지켜도 빠르게 해결할 수 있습니다.
필수 OG 태그 먼저 확인
페이지 head에 og:title, og:description, og:image가 있는지 확인하세요.
특히 og:image 누락/오타가 가장 흔한 원인입니다.
크롤러가 이미지에 접근 가능한지 확인
og:image는 상대경로가 아닌 절대 HTTPS URL이어야 합니다.
시크릿 창에서 URL을 직접 열어 로그인 없이 접근 가능한지 확인하세요.
포맷과 크기 점검
너무 작은 이미지, 비표준 형식은 미리보기 실패를 유발할 수 있습니다.
1200×630 JPG/PNG 같은 안전한 조합을 권장합니다.
캐시 재수집 처리
소셜 플랫폼은 미리보기를 캐시합니다. 수정 후에도 이전 결과가 남을 수 있습니다.
디버거/체커로 재수집을 요청해 최신 데이터를 반영하세요.
게시 전 체크리스트
아래 항목을 최종 확인하세요.
- 소스에 og:image 존재
- 절대 HTTPS 공개 URL 사용
- 헤더/robots로 차단되지 않음
- 크기 비율이 미리보기 친화적
- 재수집 요청 완료
자주 발생하는 상황
- 새 페이지 공유 시 이미지 없음
- 이미지 교체 후 예전 썸네일 고정
- 플랫폼별 표시 결과 불일치
- 팀 공통 QA 체크리스트 필요
추측보다 순서 점검
태그 → 이미지 URL → 캐시 순서로 확인하면 불필요한 재작업을 줄일 수 있습니다.