본문 바로가기

WordPress 글 이름 고유주소 설정과 404 복구 순서

실행 검증작성 SW픽 편집부 · 발행 · 수정
프로그램
WordPress
환경
macOS 26.5.1 · Apple Silicon · Playground CLI
버전
WordPress 7.0.2 · PHP 8.4
최종 검증일

Playground에서 확인한 설정 화면과 서버별 공식 복구 안내를 구분합니다. HTTP 주소 오류와 #본문 위치 링크 오류를 다른 문제로 정리했습니다.

URL 경로가 재작성 게이트를 통과해 정상 페이지로 연결되는 개념 이미지

WordPress 글 주소를 짧고 읽기 쉽게 만들려면 /%postname%/ 구조가 가장 단순합니다. 다만 운영 중인 사이트에서 무작정 바꾸면 기존 링크와 검색 유입이 끊길 수 있습니다. 이 글은 새 사이트에 적용하는 순서와, 저장 직후 글만 404가 될 때 확인할 항목을 분리해 설명합니다.

주소 자체의 404와 페이지 안의 이동 실패를 나눕니다

주소를 열자 서버가 404를 반환하는 문제와, 페이지는 200으로 열리는데 #목차 링크가 움직이지 않는 문제는 진단 지점이 다릅니다. 고유주소 복구에서 필요한 것은 공개 URL의 응답·슬러그 충돌·서버 재작성 경로입니다. 이 글에서는 주제가 다른 정적 HTML 위치 링크 검사 도구를 제거했습니다.

관리자 저장 성공만으로 공개 주소가 복구됐다고 결론 내리지 않고 홈·글·정책 주소를 각각 확인해야 합니다.

상황·관찰 판단할 지점 다음 확인
홈200, 개별 글404 글 주소 매핑과 서버 재작성 확인 현재 고유주소 값과 실패 URL 기록
기존 주소404, 새 주소200 주소 변경 후 리디렉션 누락 가능성 기존 URL을 보존할 301 경로 검토
페이지200, #링크만 실패 ID·fragment 문제 별도의 본문 위치 링크 실험으로 확인

진단용 주소에는 개인 미리보기 토큰이나 관리자 nonce를 넣지 않습니다. 공개된 주소만 기록하세요. Nginx·Apache·관리형 호스팅의 실제 설정은 서로 다르므로 Playground에서 확인한 글 이름 설정 화면을 운영 서버 재작성 규칙까지 검증한 증거로 확대하지 않습니다.

이번 검증에서 확인한 범위

macOS 26.5.1의 WordPress Playground CLI 환경에서 WordPress 7.0.2와 PHP 8.4를 사용했습니다. 설정 → 고유주소에서 ‘글 이름’이 선택되고 사용자 정의 구조에 /%postname%/가 표시되는지 확인했습니다. 설정 상태에서 실제 글 주소와 사이트의 공개 정책 페이지가 정상 응답하는지도 함께 점검했습니다.

Playground는 로컬 검증 환경입니다. Apache, Nginx, 관리형 WordPress처럼 실제 호스팅 서버가 사용하는 재작성 규칙은 서로 다릅니다. 아래의 서버별 복구 단계는 WordPress 공식 문서와 개발자 문서를 기준으로 구분했으며, 서버 설정 파일을 임의로 바꾸라는 뜻이 아닙니다.

WordPress 고유주소 옵션에서 글 이름과 /%postname%/ 구조가 선택된 확대 화면
이번 글에서 확인한 핵심 지점. ‘글 이름’을 선택하면 구조 값은 /%postname%/입니다.

변경 전에 먼저 확인할 것

  1. 신규 사이트인지 확인합니다. 이미 검색에 노출된 글이 있다면 주소 구조 변경은 모든 기존 URL에 영향을 줍니다. 이 경우 새 주소로 301 리디렉션을 설계한 뒤 변경해야 합니다.
  2. 현재 구조를 기록합니다. 설정 화면을 캡처하거나 현재 고유주소 구조를 메모합니다. 문제가 생겼을 때 원래 값으로 되돌릴 수 있어야 합니다.
  3. 백업 범위를 확인합니다. 데이터베이스와 wp-content, Apache라면 사이트 루트의 .htaccess까지 복구 가능한 백업이 있는지 확인합니다.
  4. 관리자 권한과 서버 종류를 확인합니다. WordPress 관리자 화면만 접근 가능한지, 호스팅 패널 또는 서버 설정에도 접근 가능한지에 따라 복구 방법이 달라집니다.
WordPress 7.0.2 고유주소 설정에서 글 이름 구조가 선택된 실제 화면
직접 확인한 WordPress 7.0.2 설정 화면. ‘글 이름’과 /%postname%/가 선택된 상태입니다.

글 이름 고유주소로 설정하는 순서

  1. 관리자 화면에서 설정 → 고유주소로 이동합니다.
  2. ‘일반 설정’에서 글 이름을 선택합니다. 사용자 정의 구조 칸에는 /%postname%/가 표시됩니다.
  3. 카테고리 기본과 태그 기본은 별도 계획이 없다면 비워둡니다. 여기에 같은 슬러그를 중복 입력하면 예상하지 못한 주소 충돌이 생길 수 있습니다.
  4. 변경 사항 저장을 누른 뒤 관리자 화면의 성공 알림만 보지 말고, 공개 글 하나를 새 탭에서 직접 엽니다.
  5. 홈, 글, 카테고리, 개인정보처리방침을 각각 열어 정상 표시되는지 확인합니다. 브라우저 주소창에는 쿼리 방식 ?p=123 대신 읽을 수 있는 글 슬러그가 보여야 합니다.
모바일 폭 WordPress 관리자 화면에 고유주소 구조 업데이트 완료가 표시된 실제 화면
동일한 구조로 다시 저장한 뒤 ‘고유주소 구조 업데이트됨’ 알림이 표시된 실제 결과입니다.

저장 후 글만 404일 때 복구 순서

홈과 관리자 화면은 열리는데 개별 글만 404라면, 먼저 WordPress가 재작성 규칙을 다시 만들도록 합니다. 설정 → 고유주소를 열고 구조를 바꾸지 않은 채 다시 저장한 다음, 캐시를 비우고 글 주소를 확인합니다. 이 작업은 데이터베이스의 rewrite rules를 갱신하는 가장 낮은 위험의 첫 단계입니다.

그래도 404라면 주소 슬러그 충돌을 확인합니다. 같은 슬러그의 페이지, 카테고리, 첨부파일, 사용자 정의 글 유형이 있는지 검색하고, 테스트 글의 슬러그를 임시로 고유한 값으로 바꿔 재확인합니다. 캐시 플러그인이나 CDN을 사용한다면 WordPress와 서버/CDN 캐시를 모두 비운 뒤 시크릿 창에서도 확인합니다.

Apache 호스팅인 경우

WordPress가 .htaccess에 쓰기 권한을 갖지 못하면 설정 화면은 저장돼도 서버 재작성 규칙이 갱신되지 않을 수 있습니다. 공식 문서가 안내하는 WordPress 기본 규칙과 현재 파일을 비교하되, 기존 보안·리디렉션 규칙을 덮어쓰지 마십시오. 직접 판단하기 어렵다면 호스팅 고객센터에 “고유주소 저장 후 개별 글만 404이며 mod_rewrite와 WordPress rewrite 규칙 확인이 필요하다”고 요청하는 편이 안전합니다.

Nginx 호스팅인 경우

Nginx는 WordPress가 .htaccess를 작성하는 방식이 아닙니다. 서버 블록의 try_files 등 재작성 구성이 필요하므로 관리자 화면에서 반복 저장하는 것만으로 해결되지 않을 수 있습니다. 서버 설정 권한이 없다면 WordPress 공식 Nginx 문서를 함께 보내 호스팅 사업자에게 확인을 요청합니다. 운영 서버 설정은 문법 검사와 롤백 계획 없이 수정하지 마십시오.

정상 완료 기준

  • 설정 화면에 ‘글 이름’과 /%postname%/가 표시됩니다.
  • 새 글 주소가 슬러그 기반으로 열리고 HTTP 200을 반환합니다.
  • 홈, 글, 카테고리, 정책 페이지가 모두 정상 표시됩니다.
  • 기존 공개 URL이 있었다면 새 URL로 301 리디렉션되고 연속 리디렉션이 없습니다.
  • 사이트맵에는 실제 대표 URL만 포함되며 404 주소가 남지 않습니다.

문제가 계속되면 원래 구조로 되돌리기

변경 전 기록한 고유주소 구조로 복원하고 다시 저장합니다. Apache에서 직접 파일을 수정했다면 백업한 .htaccess를 복구하고, Nginx를 수정했다면 검증된 이전 서버 설정으로 롤백합니다. 그 뒤 캐시를 비우고 대표 글 몇 개를 다시 확인합니다. 기존 사이트에서 주소 변경을 진행했다면 단순 복원으로 끝내지 말고 검색엔진과 외부 링크가 어느 주소를 가리키는지까지 점검해야 합니다.

2026-10-06 편집: 판단 사례와 적용 범위를 보강하고 출처·내부 링크를 점검했습니다. 실제 제품 앱의 실행 기록과 작성 예제는 구분합니다.

OFFICIAL SOURCES

확인한 공식 자료

CORRECTION

화면이 달라졌나요?

운영체제와 프로그램 버전, 달라진 단계를 알려주시면 다시 확인합니다.

정정 요청 보내기