추출 실패 경로의 WARN 소음과 홈 리다이렉트 판별 정리

[m-a-king]

Situation

첫날 실수신에서 드러난 것

• 추출 실패 경로의 WARN 소음과 홈 리다이렉트 판별 정리 #82
• 홈 리다이렉트는 정적 fetch 와 헤드리스 양쪽에서 생김
  • 헤드리스는 LLM 후보에서 루트 홉을 빼지 않았음
  • 헤드리스는 루트 홉의 구조화 데이터도 채택했음. 홈의 대표 상품 JSON-LD 가 등록 상품으로 저장될 수 있음

Task

WARN 소음 정리와 홈 리다이렉트 판별

• 추출 실패 경로의 WARN 소음과 홈 리다이렉트 판별 정리 #82
• 범위: 추적 파라미터 제거 항목은 보류로 제외

Action

사이트 루트 착지를 일시 실패로 분류

경로	판정 지점	동작
정적 fetch	redirect Location 이 루트인 순간	홈 본문을 받지 않고 끊음
헤드리스	홉 후보 단계, 구조화 추출보다 앞	루트 홉은 구조화 데이터·LLM 후보 모두 제외. 루트뿐이면 같은 실패

• 조건: 등록 링크 자체가 루트면 판정하지 않음
• 루트는 path 가 비었거나 / 이고 query·fragment 가 없는 URL
  • 원인: /?goodsNo=1·/#/goods/1 처럼 루트 URL 로 상품을 싣는 몰이 있음
  • 대안: 추적 파라미터(utm_*·fbclid)만 있는 query 는 루트로 인정
    • 기각: 코드에 없던 파라미터 목록 정책이 새로 생김. 놓친 경우는 이전 동작(홈 본문을 LLM 에 넘김)으로 돌아갈 뿐
• 루트 홉에서도 challenge 신호는 계속 모음
  • 원인: 차단 판정이 루트 착지보다 먼저라 최종 실패 code 가 이전과 같게 유지됨
• 구현: ProductLink.isSiteRoot, HttpPageFetcher.landsOnSiteRoot, HeadlessProductLinkExtractor, PageFetchException.redirectedToSiteRoot

선택지	장점	비용
UPSTREAM_ERROR 재사용 (채택)	계약 변경 없음	시도마다 정적 fetch 실패 뒤 렌더 1회. 건당으로는 재시도 횟수만큼
전용 code 신설	관측에서 구분 가능	infra 카탈로그·proto·core 매핑 3 repo 선행 변경

로그 레벨 조정

로그	이전	이후	원인
HttpClient ResponseProcessCookies	WARN	ERROR 미만 차단	cafe24 몰의 잘못된 Set-Cookie domain, 추출 결과 무관
fetch 4xx	WARN	INFO	없는 상품·비공개 페이지의 정상 실패. 5xx 는 WARN 유지
헤드리스 escalate 실패	WARN	INFO	예외로 전파돼 파싱 실패 알림이 되므로 알림 2건

Result

검증

• 루트 redirect 시 홈으로의 두 번째 요청이 나가지 않음을 MockRestServiceServer 의 미기대 요청 실패로 고정
• 헤드리스 루트 착지 시 LLM 호출 0회를 stub 호출 수로 고정
• 루트+query 2건·루트 홉 JSON-LD 1건 테스트 추가
  • 결과: 수정 전 코드에서 새 테스트 3건 모두 실패 확인
• 로그 레벨 조정으로 사라지는 알림 없음
  • 원인: core 범용 로그 알림은 error·critical 만 봄. extractor 로그 문구를 매칭하는 룰 0개

위험

• 위험: 삭제 상품처럼 영구적으로 홈으로 튕기는 경우도 일시 실패
  • 결과: 마감 3분 안에서 재시도마다 렌더 1회 소모. 최종 사유는 외부 불안정으로 남음
  • 원인: 추출 실패 경로의 WARN 소음과 홈 리다이렉트 판별 정리 #82 가 재시도 가능한 실패를 명시

후속

• 몰 쪽 일시 상태는 호출자 recover 재시도가 흡수

---

연관 이슈

• close 추출 실패 경로의 WARN 소음과 홈 리다이렉트 판별 정리 #82

[coderabbitai]

Important

• 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Advanced

Run ID: 44eec5c6-fe50-4a80-b95a-8f795a9969b0

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[github-actions]

Discord 스레드 연동용 메타데이터입니다. discord-pr-bot 워크플로가 자동 생성하며, 수정·삭제하면 PR 과 Discord 알림 연동이 끊깁니다.