일반적인 WordPress 오류 및 수정 방법
게시 됨: 2020-03-17WordPress CMS(콘텐츠 관리 시스템)는 처음부터 웹사이트 제작을 보다 효율적으로 만들었습니다. 그러나 완벽하지 않으며 때때로 오류가 발생합니다. 이 가이드에서는 일반적인 WordPress 오류와 해결 방법을 다룹니다.
WordPress는 많은 웹사이트인 웹의 모든 웹사이트의 36% 이상을 지원합니다. 우리는 15년 이상 WordPress를 사용해 왔으며 거의 모든 가장 일반적인 오류에 직면했습니다.
이 가이드의 수정 사항을 시도하기 전에 전체 웹 사이트와 데이터베이스를 백업했는지 확인하십시오. 계속 진행하려면 아래 목차에서 원하는 항목을 클릭하여 특정 오류를 수정하는 방법을 알아보세요.
일반적인 오류 | 어떻게 고치는 지 |
404 페이지 오류 | 어떻게 고치는 지 |
500 내부 서버 오류 | 어떻게 고치는 지 |
연결 시간이 초과되었습니다 | 어떻게 고치는 지 |
데이터베이스 연결을 설정하는 동안 오류가 발생했습니다. | 어떻게 고치는 지 |
분실한 관리자 이메일 및 비밀번호 검색이 작동하지 않음 | 어떻게 고치는 지 |
메모리 소진 오류 | 어떻게 고치는 지 |
구문 분석 오류/구문 오류 | 어떻게 고치는 지 |
유지 보수에 갇힌 | 어떻게 고치는 지 |
죽음의 백색 스크린 | 어떻게 고치는 지 |
이미지를 업로드할 수 없습니다. | 어떻게 고치는 지 |
관리 영역에 액세스할 수 없습니다. | 어떻게 고치는 지 |
사이트의 사이드바가 기본 콘텐츠 아래에 나타남 | 어떻게 고치는 지 |
404 페이지 오류
404 오류는 여러 가지 원인으로 인해 발생할 수 있는 일반적인 WordPress 오류입니다.
일반적인 원인은 오래되거나 잘못 구성된 재작성 규칙 및 영구 링크 문제입니다.
징후
사이트의 특정 영역에 액세스하려고 하면 아래 스크린샷과 같은 페이지가 표시됩니다.
대부분의 경우 관리 영역과 웹사이트의 홈페이지에는 액세스할 수 있지만 단일 페이지나 게시물에는 액세스할 수 없습니다. 그러나 관리자 영역에도 액세스할 수 없는 경우 이 문제를 해결하는 방법을 알려드리겠습니다.
수정 방법: WordPress 관리자에 액세스할 수 있는 경우
먼저 관리자 영역에 계속 액세스할 수 있는 경우 퍼머링크가 올바른지 확인하십시오. 로그인하고 마우스를 가져가거나 왼쪽 탐색 메뉴에서 '설정'을 클릭합니다. 그러면 설정 아래의 모든 메뉴 옵션이 로드됩니다. 그런 다음 '영구 링크'를 클릭하십시오.
여기에서 사용 가능한 태그를 적용하여 공통 설정 또는 사용자 정의 구조 중 하나를 선택할 수 있습니다. 조정이 완료되면 변경 사항 저장을 클릭합니다.
관리자가 액세스할 수 없는 경우
404 오류로 인해 관리자 영역에 액세스할 수 없는 경우 수행해야 하는 작업은 다음과 같습니다. 먼저 CPanel 인터페이스에 로그인하고 DATABASES 아래에 있는 'phpMyAdmin'을 클릭합니다.
왼쪽 탐색 패널에 있는 사용 가능한 목록에서 WordPress 데이터베이스 이름을 선택합니다. 그런 다음 'wp_options'를 찾아 '찾아보기'를 클릭합니다. option_name에서 siteurl을 찾아 '편집'을 클릭합니다.
무료 워드프레스 SEO 분석
WordPress 웹사이트에 더 많은 트래픽을 원하십니까? 무료 WordPress SEO 분석을 통해 트래픽을 개선하여 온라인 판매를 늘릴 수 있는 방법을 확인하십시오.
입력란(option_value)에서 URL을 변경하고 오른쪽 하단에 있는 '이동' 버튼을 클릭하면 프로세스가 완료됩니다. 이제 관리자 패널에 액세스할 수 있습니다.
500 내부 서버 오류
500 오류는 웹 서버에 연결할 수 없을 때마다 발생하며 WordPress에만 국한되지 않지만 매우 일반적입니다. WordPress에서 문제는 종종 플러그인이나 테마의 기능 파일로 인해 발생합니다. 때로는 손상된 .htaccess 파일과 PHP 메모리 제한으로 인해 이러한 문제가 발생할 수 있습니다.
징후
숫자 '500'이 표시되고 하나 이상의 진행 중인 오류 메시지가 있는 웹 페이지가 표시됩니다.
수정 방법: .htaccess 파일 손상 확인
CPanel에 로그인하고 파일 섹션 아래에 있는 '파일 관리자'를 클릭하십시오. 숨겨진 콘텐츠를 표시할지 여부를 묻는 팝업 상자가 나타날 수 있으며 표시할 경우 표시합니다. FTP(파일 전송 프로토콜) 클라이언트나 FileZilla와 같은 프로그램을 사용하여 서버 콘텐츠에 액세스할 수도 있습니다.
일단 들어가면 WordPress 설치 폴더의 '.htaccess'를 '.htaccess-old'와 같은 이름으로 바꿉니다. 파일을 천천히 두 번 탭하거나 마우스 오른쪽 버튼을 클릭하고 '이름 바꾸기'를 선택하여 수행합니다.
WordPress는 도메인에 다시 액세스하려고 하면 자동으로 새로운 .htaccess 파일을 생성합니다.
모든 플러그인 비활성화
모든 플러그인을 비활성화하고 천천히 다시 활성화할 수 있습니다. 이를 수행하는 가장 효율적인 방법은 FTP 프로그램을 사용하는 것이지만 파일 관리자를 사용할 수도 있습니다. FTP 또는 CPanel 파일 관리자를 통해 파일에 액세스하고 플러그인 폴더의 이름을 변경하기만 하면 됩니다.
플러그인 폴더는 WordPress 설치 폴더의 wp-content로 이동하여 찾을 수 있습니다. 거기에서 폴더의 이름을 바꾸면 됩니다.
이름을 다시 '플러그인'으로 변경하면 모든 플러그인이 비활성화된 상태로 유지된다는 점을 제외하고 WordPress가 모든 것을 정상으로 되돌립니다.
액세스 가능한 경우 왼쪽 탐색 메뉴에 있는 '플러그인'을 선택하여 WordPress 대시보드에서 플러그인을 비활성화할 수도 있습니다. 그런 다음 모든 플러그인을 선택하고 일괄 작업 메뉴에서 '비활성화'를 선택합니다.
모든 플러그인을 비활성화한 후 500 오류가 사라지면 특정 플러그인 문제임을 알 수 있습니다. 여기에서 플러그인을 하나씩 다시 활성화하고 매번 사이트를 다시 로드하여 범인을 찾으면 됩니다.
연결 시간 초과 오류
브라우저가 서버로부터 적시에 응답을 받지 못할 때마다 시간 초과 오류가 발생합니다. 즉, 이 오류는 두 서버의 연결이 실패할 때 발생합니다. 이 오류는 서버 연결 문제뿐만 아니라 잘못된 호스팅 구성으로 인해 발생할 수도 있습니다. 연결 시간 초과 오류는 504 게이트웨이 시간 초과라고도 합니다.
징후
페이지에 액세스를 시도할 때마다 "504 게이트웨이 시간 초과"라는 용어와 함께 흰색 화면이 표시됩니다.
수정 방법: 페이지 새로고침, VPN, 방화벽 및 프록시
가장 먼저 해야 할 일은 몇 분 후에 페이지를 다시 로드하는 것입니다(바람직하게는 15~30분). 이러한 종류의 오류는 종종 서버의 일시적인 결함으로 인해 발생하기 때문입니다.
문제가 지속되면 VPN(가상 사설망)을 사용 중인지 확인하고 끕니다. 어떤 상황에서는 VPN 서비스가 단순히 연결에 실패하거나 호스팅 서버에서 응답을 받지 못합니다.
그래도 문제가 해결되지 않으면 웹사이트의 방화벽(예: Cloudflare)을 끄고 프록시를 비활성화해 보십시오. 또한 다른 인터넷 연결이나 컴퓨터를 사용하여 사이트가 다른 사람이 아니라 나만 다운되었는지 확인하십시오.
DNS 변경
현재 서버가 다운되었을 수 있으므로 DNS(도메인 이름 시스템) 서버를 변경합니다. Windows 컴퓨터에서 이 작업을 수행하려면 시작 메뉴에서 네트워크 및 공유 센터를 검색하거나 제어판으로 이동한 다음 '네트워크 및 공유 센터'를 클릭합니다.
Mac에서는 시스템 환경설정에 액세스하여 네트워크를 선택한 다음 왼쪽 하단에 있는 '고급'을 클릭합니다. 창이 열리면 위에 있는 탭에서 DNS를 선택합니다.
DNS 설정을 Google과 같은 공개로 변경하십시오(IP 주소 8.8.8.8 및 8.8.4.4).
시도할 다른 것들
때로는 WordPress 데이터베이스를 정리하기만 하면 됩니다. Wp-Sweep과 같은 플러그인을 설치하거나 phpMyAdmin을 통해 수동으로 설치할 수 있습니다. 먼저 데이터베이스를 백업했는지 확인하십시오.
그래도 작동하지 않으면 앞에서 설명한 것처럼 모든 플러그인을 비활성화하고 한 번에 하나씩 다시 활성화해 보십시오. 너무 많은 요청을 보내는 하나 이상의 플러그인이 있을 수 있으며, 이로 인해 시간 초과 오류가 발생할 수 있습니다.
데이터베이스 연결을 설정하는 동안 오류가 발생했습니다.
이 오류가 발생하는 이유는 매우 간단합니다. 귀하의 웹사이트가 데이터베이스에 액세스할 수 없음을 의미합니다.
징후
사용자는 "데이터베이스 연결을 설정하는 동안 오류가 발생했습니다"라는 화면이 표시됩니다.
수정 방법: 데이터베이스 자격 증명 확인
가장 가능성이 높은 원인은 잘못된 데이터베이스 자격 증명이므로 시작하겠습니다.
CPanel에 로그인하고 DATABASES를 찾아 'MySQL 데이터베이스'를 클릭합니다. 거기에서 현재 데이터베이스에서 권한 있는 사용자를 찾으십시오. 그런 다음 현재 사용자로 스크롤하여 권한 있는 사용자의 암호를 변경합니다. 다음 단계에 필요하므로 새 비밀번호와 사용자 이름을 어딘가에 적어 두십시오 .
FTP 또는 파일 관리자를 사용하여 WordPress 설치 디렉토리의 파일에 액세스하고 wp-config.php를 엽니다. 다음 코드 줄(스크린샷 참조)을 찾은 다음 그에 따라 데이터베이스 암호와 사용자 이름을 편집해야 합니다.
거기에 있는 동안 데이터베이스 호스트('DB_HOST') 정보도 올바른지 확인하십시오. 이것은 일반적으로 'DB_PASSWORD' 바로 아래에 있습니다.
WordPress 데이터베이스 복구
데이터베이스 복구를 시도할 수도 있습니다. 다음 코드 줄을 wp-config.php에 추가하여 WordPress 데이터베이스 복구 기능을 실행하되 PHP 태그 및/또는 메모 뒤에 첫 번째 줄로 추가해야 합니다.
정의('WP_ALLOW_REPAIR', 참);
다음으로 yoursite.com/wp-admin/maint/repair.php를 방문하여 계속 진행합니다.
복구가 완료되면 돌아가서 해당 코드 줄을 제거해야 합니다 . 그렇지 않으면 누구나 데이터베이스 복구 도구에 액세스할 수 있습니다.
경우에 따라 WordPress URL을 업데이트하면 데이터베이스 연결 문제도 해결할 수 있습니다. 자세한 내용은 404 오류 수정 섹션을 참조하세요.
분실한 관리자 이메일 및 비밀번호 검색이 작동하지 않음
관리자 이메일 주소를 분실하여 비밀번호 검색을 사용할 수 없는 경우 쉽게 해결할 수 있습니다.
징후
비밀번호나 사용자 이름이 잘못되었거나 관리자 이메일 주소에 액세스할 수 없기 때문에 단순히 로그인할 수 없습니다.
해결 방법: 관리자 이메일에 액세스할 수 있는 경우
yourwebsite.com/wp-admin으로 이동하여 로그인 상자 아래에 '비밀번호를 분실하셨습니까?'가 표시됩니다.
'비밀번호 분실'을 클릭하고 다음 화면에서 이메일 주소를 입력한 후 '새 비밀번호 찾기'를 클릭합니다. 이메일을 통해 새 비밀번호를 생성할 수 있는 링크를 받게 됩니다.
관리자 이메일 액세스 권한 없음
데이터베이스에 접속하여 직접 변경하여 비밀번호를 재설정할 수 있습니다. 앞서 설명한 대로 CPanel을 통해 phpMyAdmin에 액세스합니다(404 오류 섹션). 하지만 이번에는 데이터베이스 이름을 선택한 후 'wp_user' 옵션을 찾은 다음 '편집'을 클릭합니다.
이제 비밀번호와 이메일 주소를 직접 수정할 수 있습니다.
메모리 소진 오류
이 오류는 일반적으로 플러그인 또는 기타 스크립트가 해당 프로그램에 할당된 기본 메모리를 초과할 때 발생합니다.
징후
일반적으로 문제를 지정하는 흰색 배경과 검은색 텍스트가 있는 페이지가 표시됩니다('치명적인 오류'로 시작).
수정 방법: PHP 메모리 제한 늘리기
사용 중인 경우 PHP 메모리 제한을 늘릴 수 있습니다. PHP 메모리 제한은 요청할 때마다 스크립트에 할당되는 메모리 양(바이트)입니다.
문제를 해결하기 위해 php.ini라는 파일을 사용할 것입니다.
- 빈 파일을 만들고 이름을 php.ini로 지정합니다.
- 다음을 붙여넣거나 입력하여 메모리 제한을 지정합니다(메모리=64MB). 번호를 원하는 대로 변경하십시오.
- 파일을 저장하고 WordPress 설치 디렉토리에 있는 wp-admin 폴더에 업로드하십시오.
CPanel 인터페이스를 통해 PHP 메모리 제한을 늘릴 수도 있습니다. 먼저 CPanel에 로그인하고 소프트웨어에서 'PHP 버전 선택'을 찾습니다.
로드되는 새 페이지에서 오른쪽 상단에 있는 'PHP 옵션으로 전환'을 클릭합니다. 아래로 스크롤하여 'memory_limit'를 찾아 다음 수준 이상으로 제한을 늘립니다.
앞서 언급한 것은 관리자 전용 500 오류에도 작동할 수 있습니다.
구문 분석 오류/구문 오류
이 문제는 잘못된 코드가 사용되어 PHP 구문 분석/구문 오류가 발생할 때마다 발생합니다.
징후
시작 줄(예: 줄 539)을 포함하여 오류를 일으키는 파일의 경로를 나타내는 'Parse error'라는 용어로 시작하는 오류 메시지입니다.
어떻게 고치는 지
FTP 또는 CPanel 파일 관리자를 통해 로그인한 다음 오류 메시지에 제공된 경로를 사용하여 문제가 있는 파일을 찾습니다. 오류 메시지에서 제공하는 줄 번호는 잘못된 구문이 있는 페이지 코드 영역을 가리킵니다. 추가한 코드가 정확한지 확인하여 구문을 수정하십시오.
수행 중인 작업을 알고 있다면 코드를 개선하거나 편집할 수도 있습니다.
유지 관리 중단/예약된 유지 관리 오류에 사용할 수 없음
이것은 완료되지 않았거나 진행중인 WordPress 업데이트로 인해 일반적으로 발생합니다. 느린 서버 응답 시간 또는 메모리 문제로 인해 업데이트 프로세스가 중단되어 WordPress에서 유지 관리 알림 파일을 삭제할 수 없습니다.
징후
"예약된 유지 관리에 잠시 사용할 수 없음"이라는 오류 메시지가 표시됩니다.
어떻게 고치는 지
먼저 FTP 또는 파일 관리자를 사용하여 웹사이트 파일에 액세스하기만 하면 됩니다. 일반적으로 FTP 프로그램의 기본 경우인 숨겨진 파일이 표시되는지 확인합니다. 그런 다음 WordPress 설치 폴더에서 .maintenance 파일을 찾아 삭제합니다.
죽음의 백색 스크린
죽음의 흰색 화면은 유명한 Windows 블루 스크린의 이름을 따서 명명되었습니다. PHP 메모리 제한이나 잘못된 서버 구성으로 인해 자주 발생합니다. 또한 모든 페이지가 아니라 사이트의 특정 섹션에서 발생할 수 있습니다.
징후
들리는 것처럼 오류 메시지가 없는 흰색 화면입니다. 좋아!
어떻게 고치는 지
서버에서 WordPress를 실행하는 다른 웹사이트가 있는 경우 문제가 발생하는지 확인하세요. 그렇지 않은 경우 새 폴더에 테스트 WordPress 설치를 설치할 수 있습니다. 다른 설치에 동일한 문제가 있는 경우 서버와 관련이 있습니다. 그렇다면 호스팅 서비스 제공업체에 도움을 요청하세요.
서버를 문제로 배제한 후 다음을 시도하여 오류를 수정하십시오.
- PHP 메모리 제한 늘리기 – '메모리 소진 오류' 섹션에 나와 있는 단계를 따르세요.
- 모든 플러그인 비활성화 – '500 내부 서버 오류' 섹션에서 설명한 단계를 따릅니다.
기본 테마로 되돌리기
기본 테마로 되돌릴 수 있습니다. FTP 클라이언트 또는 파일 관리자를 사용하여 웹사이트 파일에 액세스합니다. WordPress 설치 폴더에서 /wp-content/themes/로 이동합니다. 현재 WordPress 테마를 다운로드하여 백업하십시오.
다음으로 현재 테마를 삭제합니다. 이렇게 하면 WordPress에서 사용 가능한 기본 테마(예: Twenty Fourteen)를 강제로 사용합니다. 웹사이트를 새로고침하고 문제가 해결되면 원래 테마 functions.php 파일에서 오류를 확인하세요. 원래 테마 패키지를 다시 구입하여 특정 파일을 바꿀 수도 있습니다.
디버그 모드 활성화
WordPress 설치 폴더에 있는 여는 PHP 태그 및/또는 메모 바로 뒤에 다음 코드 줄을 wp-config.php에 추가합니다.
정의( 'WP_DEBUG', 참);
정의( 'WP_DEBUG_LOG', true );
웹사이트를 새로고침하면 오류가 표시되어야 합니다. 그렇지 않은 경우 FTP 또는 파일 관리자를 통해 서버에 로그인하고 wp-content 폴더에 액세스합니다. debug.log를 찾아 내용을 읽으려면 엽니다.
로그 파일은 추가 문제 해결을 위해 문제가 있는 위치를 알려줍니다.
이미지를 업로드할 수 없습니다.
이것은 일반적으로 잘못된 파일 권한으로 인해 발생합니다. WordPress 플랫폼이 제대로 작동하려면 서버의 콘텐츠를 수정할 수 있는 올바른 액세스 권한이 필요합니다.
징후
이미지를 업로드하려고 할 때마다 오류가 발생하거나 미디어 라이브러리에서 이미지가 사라집니다.
어떻게 고치는 지
적절한 권한을 설정해야 합니다. FTP 또는 CPanel 파일 관리자를 사용하여 웹 서버에 로그인합니다. wp-content 폴더를 열면 거기에 업로드 폴더가 있습니다. '업로드'를 마우스 오른쪽 버튼으로 클릭하고 '파일 권한'을 선택합니다. 일부 Mac 시스템에서는 '정보 입수'를 선택해야 합니다. 숫자 값 또는 8진수가 755로 설정되어 있는지 확인하고 'Apply to Enclosed' 또는 'Recurse into Subdirectories' 또는 이와 유사한 것을 클릭합니다. 이것은 FTP 클라이언트에 따라 다릅니다.
다음으로, 폴더와 하위 폴더 내의 모든 파일을 644로 설정해야 합니다. 앞에서 설명한 것과 동일한 프로세스를 사용하지만 이번에는 각 폴더에 개별적으로 액세스하고 내부의 모든 파일을 선택합니다(Windows의 경우 ctrl + A, Mac의 경우 command + A). .
관리 영역에 액세스할 수 없습니다.
관리 영역에 액세스하는 것을 거의 불가능하게 만드는 몇 가지 문제를 이미 다루었습니다(404페이지 오류 섹션 참조). 그러나 이 실패를 초래할 수 있는 다른 것이 있습니다. 쿠키를 활성화하거나 캐시를 지워야 할 수도 있습니다.
징후
로그인을 시도할 때마다 페이지가 새로 고쳐집니다.
어떻게 고치는 지
쿠키를 지우고 활성화하는 단계는 브라우저 간에 매우 유사합니다. 가장 많이 사용되는 브라우저인 Chrome에서 수행하는 방법을 알려드리겠습니다. 그렇게 하면 다른 사람들과 함께 하는 방법에 대한 좋은 아이디어를 얻을 수 있습니다.
Chrome의 경우 브라우저 오른쪽 상단에 있는 점 3개를 클릭합니다. 그런 다음 '추가 도구'를 찾아 '인터넷 사용 기록 삭제'를 클릭하십시오.
Chrome에 표시되는 팝업에서 쿠키 및 기타 사이트 데이터 가 선택되어 있는지 확인하고 '데이터 지우기'를 클릭합니다.
그런 다음 개인 정보 및 보안에서 '사이트 설정'을 클릭하여 브라우저에서 쿠키를 허용하는지 확인하십시오.
표시되는 페이지의 권한에서 Chrome이 쿠키를 허용하도록 설정되어 있는지 확인하고 그렇지 않은 경우 '쿠키 및 사이트 데이터'를 클릭합니다. 그런 다음 사이트에서 쿠키를 저장하고 읽을 수 있도록 허용합니다.
사이트의 사이드바가 기본 콘텐츠 아래에 나타남
이것은 사람들이 WordPress에서 직면하는 일반적인 문제이며 일반적으로 사용되는 테마로 인해 발생합니다. 때때로 CSS에 닫히지 않은 div 또는 부적절한 너비 및 부동 소수점 설정이 있습니다.
징후
사이드바는 콘텐츠 옆이 아니라 콘텐츠 아래에 나타납니다.
어떻게 고치는 지
앞서 언급한 원인을 해결하십시오. 테마의 너비와 부동 소수점 설정을 확인하고 닫히지 않은 div가 없는지 확인하세요.
마무리
이 가이드를 북마크에 추가하고 WordPress에 문제가 있을 때마다 사용하세요. 대부분의 경우 상황에 대한 해결책을 찾을 수 있습니다.
마지막으로 WordPress는 여전히 환상적인 플랫폼이자 웹사이트를 위한 최고의 CMS입니다. SEO 친화적이며 사용하기 쉬우며 많은 확장 기능이 제공됩니다.