← Ascendy EN

frontend

'global default OG면 안전하다'는 거짓말 — og:url과 canonical엔 기본값이 없다

· Ascendy Engineering

TL;DR

소스 노트. frontend 팀 인테이크를 정제한 글이다. 공개 도메인 ascendy.ai는 이미 공개라 예시로 그대로 쓴다(시크릿·식별자 없음). 같은 리뷰가-잡았다 결의 한 번 고친 버그가 어떻게 되살아났나, 이름 하나 바꾸는 PR이 가장 넓은 PR이었다와 이어진다.

”default 깔고 끝”이 안 통하는 한 곳

SEO baseline을 깔 때 대부분의 가이드는 이렇게 안내한다. “nuxt.config.ts head에 default Open Graph 메타를 깔아두면 전 페이지가 기본 미리보기를 갖는다. per-page override는 필요하면 나중에.”

대부분의 OG 필드엔 이게 맞다. og:image, og:site_name, default og:title/og:description — 페이지가 따로 안 잡으면 default가 합리적으로 채운다.

그런데 딱 두 필드엔 이게 함정이다: og:url과 <link rel="canonical">.

이 둘은 *“이 페이지가 정식으로 어떤 URL인가”*를 선언한다. 그래서 default 값이라는 게 애초에 의미가 없다 — 모든 페이지가 같은 값이면 안 되니까. 그런데 global default에 og:url을 https://ascendy.ai/로 박아두고 페이지별로 override를 안 하면, about·pricing·privacy·terms·licenses 페이지가 전부 자기 정식 URL을 ascendy.ai/(root)라고 선언한다.

그래서 무슨 일이 생기나

두 방향으로 깨진다.

  1. SNS 미리보기 — /about을 공유하든 /pricing을 공유하든, OG 카드가 advertise하는 URL은 전부 ascendy.ai/다. 클릭하면 엉뚱한 데로 가거나, 최소한 “이 링크가 그 페이지가 맞나” 신뢰가 깎인다.
  2. 검색 인덱싱 — 이게 더 치명적이다. 짚고 갈 게 하나 있다 — rel="canonical"은 명령이 아니라 신호다. Google은 canonical 태그와 다른 단서(내부 링크, sitemap, 리다이렉트 등)를 종합해 대표 URL을 직접 고르고, 신호가 어긋나면 무시하기도 한다. 그런데 <link rel="canonical">이 모든 페이지에서 root를 가리키면, about/pricing/privacy/terms/licenses가 전부 “내 정본은 root”라고 강하게 우기는 셈이라, Google이 root를 대표로 골라 나머지 페이지를 색인에서 제외할 위험이 크다. 확정은 아니지만, SEO baseline을 깐다면서 정작 페이지들을 검색에서 지울 수 있는 신호를 스스로 심는 것이다.

Codex 리뷰가 이걸 rg ogUrl pages/ 한 줄로 잡았다 — 페이지 어디에도 ogUrl이나 canonical override가 없다는 걸. 리뷰어가 grep 한 줄로 잡을 수 있는 종류의 결함이고, 코드 리뷰가 왜 값을 하는지를 보여주는 작은 일화다.

fix — per-page에 둘 다 명시

Nuxt 3에선 useSeoMeta가 ogUrl을 받고, canonical은 useHead의 link entry로 따로 잡는다. 같은 PR에서 둘 다 명시한다.

// pages/about.vue (다른 공개 페이지도 같은 패턴)
const pageUrl = 'https://ascendy.ai/about'
useSeoMeta({
  title: () => t('seo.about.title'),
  description: () => t('seo.about.description'),
  ogTitle: () => t('seo.about.title'),
  ogDescription: () => t('seo.about.description'),
  ogUrl: pageUrl,                              // ← 빠뜨렸던 핵심
})
useHead({ link: [{ rel: 'canonical', href: pageUrl }] })  // ← + 검색용 canonical

6개 페이지에 18줄. 그게 전부다 — 작은 누락이지만 잠재 결과가 “전 페이지가 검색에서 사라질 위험”이라 임팩트가 컸다.

(참고: prod host를 하드코딩하는 건 multi-env에선 trade-off다. dev/staging도 인덱싱이 필요하면 dynamic sitemap + runtime config가 맞다. 공개 페이지가 prod-only인 현 단계에선 prod 고정이 옳다.)

가져갈 것

저작·인용: 이 글은 Ascendy Engineering이 작성했으며 출처 표기 시 재인용 가능합니다. 잘못된 정보를 발견하면 GitHub 이슈로 알려주세요.

Tags: nuxt, seo, open-graph, canonical, lessons-from-review