IT ISSUE

워드프레스 주소 매개 변수로 인한 404 오류 해결 방법

itissue 2024. 9. 9. 06:16
반응형

 

 

워드프레스에서 주소 매개 변수로 인한 404 오류는 많은 사용자에게 자주 발생하는 문제 중 하나입니다. 이는 웹사이트의 퍼머링크 설정, 특정 플러그인의 충돌, 서버 구성 오류 등의 여러 요인으로 인해 발생할 수 있습니다. 다행히도, 이 문제를 해결하기 위한 다양한 방법이 있으며, 각 단계별로 문제를 진단하고 해결할 수 있는 가이드를 제공하겠습니다.

1. 퍼머링크 설정 확인 및 재저장

워드프레스에서 퍼머링크 설정은 웹사이트 URL 구조를 정의하는 중요한 요소입니다. 주소 매개 변수로 인해 404 오류가 발생하는 경우, 먼저 퍼머링크 설정을 재저장해 보는 것이 좋습니다. 이 작업은 웹사이트의 URL 리라이트 규칙을 새로고침하여 문제를 해결하는 데 도움이 될

수 있습니다.

  1. 워드프레스 대시보드에 로그인한 후, 좌측 메뉴에서 설정 -> 퍼머링크로 이동합니다.
  2. 현재 설정을 그대로 둔 채로 저장 버튼을 클릭합니다. 설정을 변경할 필요는 없습니다.
  3. 이 작업을 통해 .htaccess 파일이 자동으로 새로 작성되며, 이로 인해 발생한 URL 문제를 해결할 수 있습니다.

퍼머링크 설정을 재저장하는 이 간단한 방법은 종종 복잡한 문제를 해결할 수 있으며, 특히 서버의 URL 리라이트 규칙이 제대로 적용되지 않을 때 효과적입니다.

2. 플러그인 충돌 확인

워드프레스에서 사용 중인 플러그인이 주소 매개 변수를 처리하는 방식에 영향을 미쳐 404 오류를 유발할 수 있습니다. 특정 플러그인에서 URL 리라이트 규칙을 변경하거나, 주소 매개 변수를 제대로 처리하지 못할 경우 이러한 문제가 발생할 수 있습니다.

  1. 먼저 모든 플러그인을 비활성화합니다. 이는 워드프레스 대시보드의 플러그인 메뉴에서 일괄 비활성화를 통해 쉽게 할 수 있습니다.
  2. 모든 플러그인을 비활성화한 후, 주소 매개 변수가 포함된 URL을 다시 확인하여 404 오류가 여전히 발생하는지 점검합니다.
  3. 만약 문제가 해결되었다면, 플러그인 중 하나가 문제를 일으키고 있을 가능성이 높습니다. 이제 하나씩 플러그인을 활성화하여, 어떤 플러그인이 문제의 원인인지 확인합니다.

플러그인 충돌을 식별하고 해결하는 이 방법은 다소 시간이 걸릴 수 있지만, 충돌 원인을 정확히 찾아낼 수 있는 가장 확실한 방법입니다.

3. .htaccess 파일 확인 및 수정

워드프레스 사이트의 .htaccess 파일은 웹사이트의 URL 리라이트 규칙을 정의하는 데 중요한 역할을 합니다. 이 파일이 손상되었거나 잘못 구성되면 404 오류가 발생할 수 있습니다. 따라서 .htaccess 파일을 점검하고 필요시 수정하는 것이 중요합니다.

  1. FTP 클라이언트를 사용하여 웹사이트의 루트 디렉토리에 접속합니다. 여기서 .htaccess 파일을 찾을 수 있습니다.
  2. .htaccess 파일을 다운로드한 후, 안전을 위해 백업을 만들어 둡니다.
  3. 파일을 열고, 아래 기본 설정으로 대체합니다:
  4. # BEGIN WordPress <IfModule mod_rewrite.c> RewriteEngine On RewriteBase / RewriteRule ^index\.php$ - [L] RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule . /index.php [L] </IfModule> # END WordPress
  5. 수정된 .htaccess 파일을 저장하고 다시 서버에 업로드합니다.
  6. 마지막으로, 워드프레스 대시보드에서 퍼머링크 설정을 재저장하여 변경 사항을 적용합니다.

이렇게 .htaccess 파일을 수정하면 파일과 관련된 URL 리라이트 문제를 해결할 수 있으며, 이로 인해 발생한 404 오류를 제거할 수 있습니다.

4. 서버 설정 확인

워드프레스 사이트가 제대로 작동하려면 서버 설정이 올바르게 구성되어 있어야 합니다. 특히 Apache나 Nginx 서버에서 주소 매개 변수를 처리하는 방식이 잘못 설정되면 404 오류가 발생할 수 있습니다.

Apache 설정 확인:

Apache 서버를 사용하는 경우, httpd.conf 파일에서 특정 지시어를 확인해야 합니다. 특히, .htaccess 파일이 제대로 작동하도록 AllowOverride 지시어가 올바르게 설정되어 있는지 확인해야 합니다.

  1. 서버의 httpd.conf 파일을 열고, 다음과 같이 설정되어 있는지 확인합니다:
  2. <Directory "/var/www/html"> AllowOverride All </Directory>
  3. 설정이 맞지 않다면, AllowOverrideAll로 변경한 후, 파일을 저장하고 Apache 서버를 재시작합니다.

이 설정은 .htaccess 파일이 올바르게 적용되도록 하며, 이로 인해 주소 매개 변수 관련 오류를 해결할 수 있습니다.

Nginx 설정 확인:

Nginx 서버를 사용하는 경우, 서버의 nginx.conf 파일을 확인하여 URL 리라이트 규칙이 올바르게 설정되어 있는지 점검합니다.

  1. nginx.conf 파일에서 try_files 설정을 찾아 다음과 같이 설정되어 있는지 확인합니다:
  2. location / { try_files $uri $uri/ /index.php?$args; }
  3. 필요한 경우 설정을 수정하고 파일을 저장한 후, Nginx 서버를 재시작합니다.

Nginx 서버의 경우 try_files 설정이 잘못되었을 때 주소 매개 변수를 포함한 URL에서 404 오류가 발생할 수 있습니다. 이를 올바르게 설정하면 문제를 해결할 수 있습니다.

5. 테마 문제 확인

때로는 워드프레스 테마의 잘못된 코딩으로 인해 주소 매개 변수와 관련된 404 오류가 발생할 수 있습니다. 이 경우, 테마를 기본 테마로 변경하여 문제가 해결되는지 확인하는 것이 필요합니다.

  1. 워드프레스 대시보드에서 외모 -> 테마로 이동하여 기본 테마(예: Twenty Twenty-One)를 활성화합니다.
  2. 기본 테마로 변경한 후, 문제가 해결되는지 확인합니다.

문제가 해결된다면, 현재 사용 중인 테마의 코드에 문제가 있는 것이므로, 해당 테마의 개발자에게 문의하거나 코드를 수정해야 할 필요가 있습니다.

6. 워드프레스 재설치

모든 방법을 시도해도 문제가 해결되지 않는다면, 워드프레스를 다시 설치하는 것도 하나의 방법이 될 수 있습니다. 이 과정은 워드프레스 코어 파일을 새로 설치함으로써 손상된 파일을 복구하고 문제를 해결하는 데 도움을 줄 수 있습니다. 다만, 이 작업을 하기 전에 반드시 웹사이트 전체를 백업해 두는 것이 중요합니다.

  1. 워드프레스 대시보드에서 도구 -> 사이트 상태로 이동하여 모든 파일이 최신 버전인지 확인합니다.
  2. 업데이트 섹션에서 워드프레스를 다시 설치하는 옵션을 선택합니다.

이 과정을 통해 손상된 파일이 복구되고, 404 오류와 같은 문제가 해결될 수 있습니다.

결론

워드프레스에서 주소 매개 변수로 인해 발생하는 404 오류는 매우 불편할 수 있지만, 올바른 진단과 해결 방법을 통해 문제를 해결할 수 있습니다. 퍼머링크 설정을 재저장하거나, 플러그인 충돌을 확인하고, .htaccess 파일을 수정하는 것과 같은 기본적인 방법부터 시작해보세요. 서버 설정을 점검하고, 테마와의 호환성을 확인하며, 필요시 워드프레스를 재설치하는 과정까지 단계별로 문제를 해결할 수 있습니다. 이 과정에서 차근차근 문제의 원인을 파악하고 해결한다면, 복잡한 문제도 쉽게 해결할 수 있을 것입니다.

반응형