카페24 상품 등록했는데 상세페이지가 404일 때, 분류 미지정 함정

카페24에 상품을 등록했는데 상세페이지가 404로 뜨는 경우가 있습니다. 진열함, 판매함 전부 켜져 있고 관리자 미리보기에서는 멀쩡히 보이는데, 로그아웃한 브라우저로 열면 /product/detail.html?product_no=N이 404를 반환합니다.

실제로 겪고 원인을 잡기까지 스킨과 캐시를 다 뒤졌기 때문에, 같은 증상을 만난 분이 헤매지 않도록 진단 순서를 정리합니다.

증상

• 관리자에서 상품 상태는 진열함, 판매함
• 관리자 미리보기에서는 상세페이지 정상 렌더
• 로그아웃 상태(익명)로 접속하면 상품 상세 URL이 404
• cate_no 파라미터를 붙여도, SEO형 URL로 접근해도 동일하게 404

헷갈리는 오답 두 가지

첫 번째 오답은 스킨 문제입니다. /product/detail.html을 파라미터 없이 열어도 404가 나오기 때문에, 스킨에 상세 템플릿 파일이 없다고 판단하기 쉽습니다. 저도 처음에 이 길로 갔습니다. 그런데 스마트디자인 편집기에서 확인하면 파일은 멀쩡히 존재합니다.

두 번째 오답은 캐시입니다. 관리자의 사이트캐시 삭제를 눌러도 결과는 바뀌지 않습니다.

진짜 원인: 상품이 어떤 분류에도 속하지 않음

카페24는 어느 상품분류(카테고리)에도 지정되지 않은 상품의 상세 URL을 프론트에서 404로 처리합니다. 진열함, 판매함 설정과는 별개입니다. 상품 등록 화면에서 분류 지정을 건너뛰면 저장은 정상적으로 되지만, 고객이 볼 수 있는 페이지는 생기지 않습니다.

같은 몰에서 분류가 지정된 상품은 200, 분류가 없는 상품만 404가 나는 것을 상품별로 대조해 확인했습니다.

해법

1. 관리자에서 상품 > 상품목록으로 이동합니다.
2. 404가 나는 상품을 선택하고 분류수정을 엽니다.
3. 아무 대분류든 하나를 골라 "선택한 상품 분류 추가"를 실행합니다.
4. 저장 직후 익명 브라우저에서 상세 URL을 다시 열면 200으로 바뀝니다. 별도 캐시 삭제는 필요 없었습니다.

진단 요령

상세만 404이고 /product/list.html, /order/basket.html, /member/login.html이 전부 200이라면 스킨 파일 문제가 아닐 가능성이 높습니다. 이 조합이 보이면 분류부터 확인하세요. 스킨 편집기를 여는 것보다 훨씬 빠릅니다.