태그가 아니라 목적지 문서부터 엽니다
문제가 보고된 페이지에서 canonical 값을 추출한 뒤 그 주소를 별도로 요청합니다. 최초 코드와 최종 도착 페이지를 함께 저장합니다. 200이어도 로그인 폼이나 권한 오류라면 공개 문서의 대표 후보로 적절한지 다시 판단해야 합니다. 운영자의 로그인 브라우저에서는 정상으로 보이지만 익명 방문자는 접근하지 못하는 경우를 놓치지 않습니다.
목적지가 틀린 원인을 나눕니다
호스트가 미리보기 주소인지, 상대 경로 조립에서 디렉터리가 중복됐는지, 끝 슬래시나 대소문자 변환이 배포 구조와 다른지 확인합니다. 콘텐츠의 slug만 바꾸고 메타데이터의 예외값은 남긴 경우도 찾습니다. 전체 사이트에서 같은 잘못된 목적지가 반복되면 페이지별 수동 수정보다 공통 URL 함수나 환경 설정을 우선 점검합니다.
수정 전에 대표 문서의 유지 방식을 정합니다
- 목적지 문서가 실제로 존재해야 하는지 콘텐츠 담당자에게 확인합니다.
- 문서가 옮겨졌다면 새로운 장기 주소와 내용을 확인합니다.
- 원본과 목적지가 같은 정보를 제공하는지 비교합니다.
- 대표 문서를 정한 뒤 메타데이터, 내부 링크와 사이트맵에 동일한 주소 정책을 적용합니다.
설계 예시로 /guide/a/의 canonical이 /preview/guide/a/로 잘못 조립된 경우, 미리보기 경로를 운영에서 억지로 복원하는 것보다 URL 생성의 기준 경로를 고치는 편이 재발을 막습니다. 다만 /preview/가 실제 별도 콘텐츠인 상황이라면 이름만으로 오류라고 단정하지 말고 운영 구조를 확인합니다.
배포 후 판정 표를 남깁니다
검사한 원본 URL, 수정 전 목적지, 수정 후 목적지, 목적지의 최종 코드와 본문 확인 결과를 한 줄로 남깁니다. 같은 템플릿의 다른 문서도 표본 검사해 수정 범위가 충분한지 확인합니다. 브라우저 렌더링 뒤 canonical이 다시 덮어써지는지도 확인하고, 빌드 결과와 실서비스 응답이 다른 경우 배포 설정을 추적합니다.
검색도구 결과의 해석
올바른 태그로 수정된 사실과 검색엔진이 선택한 대표 주소는 별도 항목입니다. 검사 도구가 이전 데이터를 보여 주는 경우 검사 시점과 마지막 수집 시점을 구분합니다. 상태 변경을 기다리는 동안 동일한 문서의 주소를 반복 변경하거나 다른 페이지를 무조건 대표로 지정하지 않습니다.
자주 묻는 질문
- 목적지가 잠깐 장애일 때 canonical을 다른 곳으로 바꿔야 하나요?
- 일시적인 장애와 영구적인 문서 변경을 먼저 구분합니다. 장기 주소 정책을 매 장애마다 바꾸면 다른 신호까지 흔들리므로 원래 문서의 복구 가능성과 운영 결정을 확인합니다.
- 문서가 사라졌다면 가장 가까운 허브를 대표로 써도 되나요?
- 동일하거나 매우 유사한 문서의 대표 지정인지, 다른 정보로 이동시키는 결정인지 구분합니다. 허브가 원래 질문의 답을 제공하지 않으면 canonical만으로 대체 관계를 만들지 않습니다.
공식 참고자료와 작성 기준
공식 문서는 도구·검색 기능의 근거이며, 위의 점검 순서와 완료 기준은 현랩의 실무 설계 제안입니다. 예시를 실제 고객의 성과나 검색엔진의 보장으로 해석하지 않습니다.