FAQ
자주 발생하는 문제(영상/지도/캐시)를 원인별로 정리했습니다. 대부분은 채널 ID 또는 서버 환경(HTTPS outbound/타임아웃)에서 발생합니다.
영상이 안 나와요
채널 ID가 정확한지 확인해 주세요. 서버 환경에서 YouTube RSS로 outbound https 접근이 막혀있거나 타임아웃이 걸릴 수 있습니다.
증상: 일부 팀만 비거나, 전체가 빈 목록으로 보임
구장이 적게 보여요
구장 목록은 배열 데이터로 관리됩니다. stadiums 배열에 추가하면 자동으로 노출됩니다. (홈에서는 일부만 미리보기로 보여줄 수 있습니다.)
캐시
RSS 결과는 /cache에 저장되며 기본 30분 TTL입니다. 업데이트가 늦어 보이면 TTL 이후 자연 갱신됩니다.
서버 권한 문제로 cache 폴더 생성/쓰기 실패 시 최신 반영이 불안정할 수 있습니다.
지도가 안 떠요
지도는 Google Maps 임베드를 사용합니다. 외부 iframe이 차단되는 환경(일부 브라우저 확장/보안 설정)에서는 표시되지 않을 수 있습니다.
대안: 카드의 “지도 열기” 버튼으로 새 창에서 확인
구장/팀 URL이 바뀌나요?
팀/구장 페이지는 슬러그 기반(/team/{slug}, /stadium/{slug})입니다. 배열의 slug 값이 바뀌면 URL도 바뀌니, 변경 시에는 신중하게 관리하세요.