Custom Post Type 404 Errors
사용자 정의 글 유형 URL이 404이면 같은 이름의 일반 페이지가 있는지와 고정주소 규칙을 확인해야 합니다.
빠른 답변
- 우선 확인할 원인
- 사용자 정의 글 유형 URL만 404이면 같은 이름의 일반 페이지가 있는지 확인하고, 없으면 WordPress 관리자에서 기본 고정주소를 저장한 뒤 선호 고정주소를 다시 저장해 재확인해야 합니다.
- 먼저 확인할 항목
- 404가 사용자 정의 글 유형 URL에서만 발생하는지와 일반 글·페이지 URL의 상태를 비교합니다.
- 적용 범위
- 현재 증상과 본문에 적은 관찰 조건이 함께 확인된 경우
- 출처 확인일
- 2026-07-27
- 최종 검토
- 2026-07-27
- 수정일
- 2026-07-27
- 정정 이력
- 2026-07-29 이후 기록 없음
- 관련 기술
현재 증상
- 애플리케이션 오류 메시지
먼저 확인할 항목
404가 사용자 정의 글 유형 URL에서만 발생하는지와 일반 글·페이지 URL의 상태를 비교합니다.
사용자 정의 글 유형과 일반 페이지가 같은 이름 또는 slug를 사용하는지 확인합니다.
최근 사용자 정의 글 유형 등록 코드, slug, 고정주소 설정을 변경했는지 기록합니다.
현재 고정주소 설정을 기록한 뒤 기본 고정주소를 저장하고, 선호 설정을 다시 저장한 뒤 같은 URL을 재확인합니다.
피해야 할 조치
주의
- 실제 페이지 또는 사용자 정의 글 유형의 이름·slug를 바꾸기 전에는 영향받는 URL과 내부 링크를 확인합니다.
- 고정주소 설정과 slug·등록 코드를 한 번에 바꾸지 않습니다. 한 변경 뒤 같은 URL을 다시 확인합니다.
환경별 원인과 조치
확인
- 404가 사용자 정의 글 유형 URL에서만 발생하는지와 일반 글·페이지 URL의 상태를 비교합니다.
- 사용자 정의 글 유형과 일반 페이지가 같은 이름 또는 slug를 사용하는지 확인합니다.
- 최근 사용자 정의 글 유형 등록 코드, slug, 고정주소 설정을 변경했는지 기록합니다.
조치와 재확인
현재 고정주소 설정을 기록한 뒤 기본 고정주소를 저장하고, 선호 설정을 다시 저장한 뒤 같은 URL을 재확인합니다.
실제 페이지 또는 사용자 정의 글 유형의 이름·slug를 바꾸기 전에는 영향받는 URL과 내부 링크를 확인하세요. 고정주소 설정과 slug·등록 코드를 한 번에 바꾸지 말고, 한 변경 뒤 같은 URL을 다시 확인합니다.
이 절차는 사용자 정의 글 유형 URL의 404에만 적용합니다. 모든 URL이 404이거나 서버 오류 화면이 함께 나타나면 이 문서로 원인을 확정하지 마세요.
관찰값 기록
문제가 발생한 URL 또는 화면, 표시 시각, 운영 환경과 최근 변경 사항을 먼저 기록합니다. 화면이나 로그에 오류 문구가 일부만 보이면 앞뒤 문장을 보존하고 비밀번호·토큰·쿠키·개인정보는 가립니다.
다음 항목을 실제 값과 함께 확인합니다.
- 404가 사용자 정의 글 유형 URL에서만 발생하는지와 일반 글·페이지 URL의 상태를 비교합니다.
- 사용자 정의 글 유형과 일반 페이지가 같은 이름 또는 slug를 사용하는지 확인합니다.
- 최근 사용자 정의 글 유형 등록 코드, slug, 고정주소 설정을 변경했는지 기록합니다.
- 현재 고정주소 설정을 기록한 뒤 기본 고정주소를 저장하고, 선호 설정을 다시 저장한 뒤 같은 URL을 재확인합니다.
판정 기준
오류 문구가 일치해도 같은 원인이 확정되는 것은 아닙니다. 웹서버·런타임·운영체제·플랫폼과 최근 변경 사항을 비교하고, 기대한 관찰값이 나오지 않으면 다음 단계로 넘어가지 않습니다. 이 문서는 출처가 확인한 범위만 설명하며, 범위를 벗어난 원인과 조치는 단정하지 않습니다.
안전한 다음 확인
설정·권한·데이터를 변경하기 전에 백업과 되돌리기 방법을 기록합니다. 운영 환경의 방화벽 전체 해제, 인증서 검증 우회, 데이터 삭제, 비밀값 공개를 기본 조치로 사용하지 않습니다. 확인 결과가 문서의 조건과 다르면 관련 Platform·Component 문서와 공식 출처를 먼저 확인합니다.
참고 자료
WordPress · 공식 자료 · 확인 범위: 사용자 정의 글 유형과 일반 페이지가 같은 이름을 쓰는지 확인하도록 안내합니다., WordPress는 기본 고정주소를 저장한 뒤 선호 고정주소를 다시 저장해 rewrite rules를 갱신하도록 안내합니다. · 확인일: 2026-07-27