워드프레스 마이그레이션, 복제 후 오류 404 에러 해결 방법 5가지
안녕하세요. 웹피디아 입니다.
오늘은 워드프레스 마이그레이션 혹은 복제 후 나타나는 404 에러 해결 방법 5가지를 소개해드리겠습니다.
제가 얼마 전에 마이그레이션 후 404 에러를 겪었는데요. 덕분에 밤새고 새벽까지 휴..
저도 워드프레스 독학하면서 골머리 앓아가며 직접 겪었던 일들이 많은데요.
제가 블로그를 하면서 좋은 점은 여러분께 이런 일들을 소개해드릴 수 있다는 것 같습니다.
조금이라도 더 빠르게 해결하게끔 도움을 드릴 수도 있구요.
워드프레스 웹사이트 마이그레이션 혹은 복제 후 나타나는 404 에러 해결 방법에 대해서 알아보겠습니다.
워드프레스 404 오류란?
404 오류는, 서버가 사용자가 요청한 파일 또는 페이지를 찾을 수 없을 때 발생하는 HTTP 응답 코드입니다.
이에 대한 응답으로 웹 호스팅 서버는 사용자에게 “404 찾을 수 없음”이라는 오류 메시지를 자동으로 전송한다고 합니다.
워드프레스 404 오류는 일반적으로 다음과 같은 경우에 발생합니다.
- 사이트를 다른 호스팅 서버로 마이그레이션 했을 때
- URL의 고유주소 구조(permalink structure)를 변경했으며 이전 URL을 리디렉션 하지 않았을 때
- 파일 권한(authority)이 없을 때
- 잘못된 URL을 열었을 때
- 플러그인/테마 코드가 잘 못 되었을 때
프리미엄 워드프레스 테마들은 404 오류 페이지를 기본 흰 바탕에 404가 뜨게 하는 것이 아닌, 색다른 레이아웃과 옵션을 제공하기도 합니다.
워드프레스 마이그레이션, 복제 후 오류 404 에러 해결 방법
워드프레스 마이그레이션, 복제 후 404 오류 해결 방법 5가지
1. 브라우저 캐시 및 쿠키 지우기
가장 먼저 시도해야 할 문제 해결 방법은 브라우저 캐시와 쿠키를 지우는 것입니다.
또는 시크릿 모드나 게스트 모드로 사이트 방문을 시도해볼 수 있겠습니다.
이 방법은 가장 간단하지만, 이렇게 해서 바로 해결된다면 그건 축복 받으신 거라고 말씀드릴게요.
2. 고유주소 구조 설정
가장 대중적이고 유명한 해결 방법 중 하나 입니다.
다만 제가 겪었던 404 오류 의 경우는 아예 워드프레스 어드민 페이지 자체에 들어갈 수 없었습니다.
그럴 경우 호스팅 서버의 데이터베이스에 직접 들어가서 고유주소 구조를 수정해볼 수도 있는데요.
그렇게 수정해봤지만, 워드프레스 어드민 자체에 들어갈 수 없는 404 오류 라면 고유주소 구조 설정 변경이 해결책은 아닌 것 같았습니다.
홈 화면 외에 웹 사이트 페이지에서 404 페이지를 찾을 수 없음 오류가 표시되는 경우, 아래 단계에 따라 고유주소 구조 설정을 업데이트를 해볼 수 있겠습니다.
- 워드프레스 어드민 대시보드에 로그인합니다.
- 설정 탭 → ‘고유주소’로 이동합니다.
- 일반을 선택합니다.
- 변경사항 저장 버튼을 클릭합니다.
- 설정을 이전 구성(기본값 이전에 선택한 구조)으로 변경합니다. 이전에 사용자 지정 구조로 설정하셨던 경우 다시 그렇게 설정합니다.
- 설정을 또 한번 저장해줍니다.
이전에 사용자 지정 고유 주소 구조를 사용하셨던 경우, 기본 설정으로 변경하기 전 꼭 복사를 해서 어디에 저장해 놓고 이후 붙여넣기 해서 다시 되돌려 주세요.
“WordPress permalinks not working” 라는 에러 문구가 뜰 때도 이 방법을 동일하게 사용해서 해결해볼 수 있습니다.
워드프레스 마이그레이션, 복제 후 오류 404 에러 해결 방법 5가지
3. ‘.httaccess’ 파일 복원
.htaccess는 숨겨진 파일이므로 모든 파일을 FTP에 표시되도록 설정해야 합니다.
※파일이나 페이지를 편집하기 전에 항상 사이트를 백업하는 것이 좋습니다.
- 호스팅 사이트 내 c패널로 들어가서 파일 매니저(File Manager)에 로그인합니다.
- 웹 사이트 폴더에 들어가주세요. /wp-content/wp-admin/wp-includes/와 같은 폴더와 동일한 위치에 있는 .htaccess 파일을 다운로드합니다.
- 오른쪽 마우스로 클릭해서 Edit를 눌러주세요.
- 워드프레스 .htaccess 지원 페이지를 방문하여 웹 사이트에 가장 적합한 코드 버전을 복사/붙여넣기 하세요.
- .htaccess 파일을 저장 해주세요.
예를 들어, 일반적인 워드프레스를 사용하고 있는 경우, 코드가 아래와 같습니다.
# BEGIN WordPress
RewriteEngine On
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
# END WordPress
4. 301 리디렉션 설정
특정 페이지의 URL을 변경했지만 아직 리디렉션 하지 않은 경우, 이전 URL을 새 URL로 리디렉션 해야 합니다.
플러그인 또는 .htaccess 파일을 통해 이전 게시물 혹은 페이지를 리디렉션 할 수 있습니다.
.htaccess로 작업하는 것이 편하다면 다음 코드를 .htaccess 파일에 추가하세요. URL을 자신의 웹 사이트로 바꾸는 것을 잊지 마세요.
Redirect 301 /oldpage.html https://www.mywebsite.com/newpage.html
조금 더 쉬운 방법을 선호하는 경우 플러그인을 사용하여 301 리디렉션을 설정할 수 있습니다.
- ‘Redirection’ 플러그인을 설치합니다.
- 워드프레스 어드민으로 이동합니다.
- 도구 탭 > Redirection 을 클릭합니다.
- Add New를 눌러 새 리디렉션을 추가합니다.
워드프레스 마이그레이션, 복제 후 오류 404 에러 해결 방법 5가지
5. 워드프레스 플러그인/테마 비활성화
오래되거나 코드가 제대로 작동하지 않는 플러그인으로 인해 워드프레스 404 오류가 발생할 수 있습니다.
플러그인을 비활성화하고 현재 테마를 변경해보는 방법으로 404 오류를 해결해볼 수 있습니다.
우선, 워드프레스 404 에러 원인이 플러그인이 맞는지 확인부터 해봐야겠죠?
호스팅 사이트의 c패널로 들어가서 웹사이트 폴더(저의 경우 폴더 이름을 헷갈리지 않게 webpedia.kr로 저장해놨습니다.) > wp-content로 이동하여 ‘plugins’ 폴더 이름을 ‘webplugins’와 같은 임의의 이름으로 변경해주세요.
이렇게 되면 워드프레스가 플러그인 폴더를 인식을 못해서 플러그인이 전부 비활성화 됩니다.
이제 브라우저로 돌아가서 워드프레스 웹 사이트가 작동하는지 확인해주세요.
더 이상 404 에러가 뜨지 않는다면 플러그인 중 하나, 또는 몇 개가 원인일 수 있습니다.
이 방법으로 더 이상 워드프레스 404 오류 가 뜨지 않는다면, ‘webplugins’ 폴더 이름을 다시 ‘plugins’으로 변경하고 아래 단계에 따라 오류의 원인이 되는 플러그인을 확인해보세요.
- 워드프레스 어드민으로 이동합니다.
- 플러그인 > 설치한 플러그인으로 이동합니다.
- 각 플러그인을 1개씩 비활성화하고 웹 사이트가 작동하는지 확인합니다.
- 404 오류가 더이상 발생하지 않으면 어떤 플러그인이 원인인지 알 수 있습니다.
- 플러그인을 업데이트하거나 제거하여 오류를 제거합니다.
저 같은 경우는, 마이그레션 및 복제 후 404 에러 가 뜨면서 워드프레스 어드민 조차 들어가지지 않는 상황이었습니다.
따라서, 아래와 같이 워드프레스 어드민이 아닌 호스팅 사이트 내 워드프레스 툴킷에서 하나씩 비활성화 시켜보며 원인이 된 플러그인 1개를 찾아 삭제했습니다.
이렇게 워드프레스 마이그레이션 혹은 복제 후 나타나는 404 에러 해결 방법 5가지를 소개해드렸는데요.
도움이 되시길 바라겠습니다. 저도 정말 애먹었거든요ㅠㅠ
감사합니다. 다음에 또 좋은 정보로 만나뵙겠습니다.