워드프레스에서 자주 발생하는 10가지 오류(및 해결 방법)

50%의 시장 점유율을 가진 콘텐츠 관리 시스템(CMS) 도구인 워드프레스는 그 자체로 표준이 되었습니다. 그러나 모든 도구와 마찬가지로 가끔 워드프레스 문제에 직면할 수 있습니다. 이러한 문제 중 일부는 사용자에게 원인이 있고, 다른 일부는 소프트웨어/서버/웹 호스트의 문제입니다.

아래는 여러분이 직면할 수 있는 10가지 일반적인 워드프레스 문제와 이를 스스로 해결할 수 있는 방법입니다.

참고: 이 튜토리얼은 여러분이 cPanel 접근이 가능한 공유 호스팅에 있다는 가정하에 작성되었습니다.

목차

• 1. 빈 흰 화면
• 2. 내부 서버 오류
• 3. 데이터베이스 연결 오류
• 4. 워드프레스 대시보드에 접근할 수 없음
• 5. 연결 시간 초과
• 6. 워드프레스 관리자 영역에서 잠김
• 7. 로그인 페이지가 계속 리디렉션됨
• 8. 워드프레스가 유지 관리 모드에 갇힘
• 9. 워드프레스에 이미지 업로드 불가
• 10. 404 오류 수정

1. 빈 흰 화면

이 문제는 발생 시 일반적인 빈 화면을 표시하고 가능한 원인에 대한 힌트를 제공하지 않기 때문에 “죽음의 흰 화면”으로도 알려져 있습니다. 해결하기 가장 어려운 문제 중 하나입니다.

이 문제의 원인은 여러 가지가 있으며, 이에 대한 해결책도 여러 가지가 있습니다. 여기 나열된 해결책을 확인해 보세요.

2. 내부 서버 오류

내부 서버 오류는 종종 소프트웨어 충돌, 소프트웨어 오작동 또는 서버 서비스의 중단으로 인해 발생합니다. 일반적으로 서버가 소프트웨어를 실행할 수 없거나 PHP 또는 Apache와 같은 서버 서비스에 연결할 수 없을 때 발생합니다. 아래의 해결책을 시도하여 문제를 해결해 보세요.

서버 업데이트 오류

사이트에 아무런 변경을 하지 않았는데 갑자기 이 오류가 발생했다면, 웹 서버의 내부 변경(서버 또는 PHP 버전 업그레이드, 충돌을 일으키는 자동 플러그인 업데이트 등)에 대한 반응일 수 있습니다. 웹 호스트에 연락하여 서버를 점검해 달라고 요청하세요.

퍼머링크 오류

이 오류가 사이트의 퍼머링크 구조를 변경한 후 발생했다면, 그것이 오류의 원인일 가능성이 높습니다.

1. cPanel에서 파일 관리자를 엽니다.

2. “설정”을 클릭합니다.

3. “숨겨진 파일 표시” 옆의 체크박스를 선택합니다.

“.htaccess” 파일을 찾아 “.htaccess_old”로 이름을 변경합니다.

사이트를 다시 로드해 보세요. 작동하지 않으면 퍼머링크를 재설정해야 합니다. 워드프레스 대시보드에서 이 작업을 수행할 수 있습니다.

1. 워드프레스 대시보드로 이동합니다. 설정을 열고 “퍼머링크”로 이동합니다.

2. 페이지 하단으로 스크롤하여 “저장”을 클릭합니다. 이 작업은 웹사이트에 대한 새로운 오류 없는 “.htaccess” 파일을 생성합니다.

플러그인/테마 오류

때때로 잘못 작성된 플러그인이 데이터베이스에 문제를 일으킬 수 있습니다. 이를 수정하려면 워드프레스 대시보드로 가서 모든 플러그인을 비활성화합니다. (워드프레스 대시보드에 접근할 수 없는 경우 “plugins” 폴더의 이름을 “plugins.old”로 변경하고 새로운 빈 “plugins” 폴더를 만듭니다.) 웹사이트를 다시 로드합니다. 웹사이트가 다시 온라인 상태가 되면 설치된 플러그인을 하나씩 다시 활성화합니다. 각 플러그인을 다시 활성화한 후 사이트를 테스트하여 문제를 일으키는 플러그인을 찾습니다.

또한 이 오류는 테마 업데이트로 인해 발생할 수 있습니다. 기본 워드프레스 테마로 다시 전환하고 웹사이트를 로드해 보세요. 웹사이트가 다시 온라인 상태가 되면 테마에 문제가 있는 것입니다.

PHP 메모리 오류

이 방법이 모두 작동하지 않으면 “wp-config.php” 파일에서 최대 메모리 한도를 늘려 PHP 메모리 오류를 해결합니다. 방법은 다음과 같습니다.

1. cPanel로 가서 파일 관리자를 클릭합니다.

2. “public_html” 폴더를 열고 “wp-config.php”라는 파일을 찾을 때까지 스크롤합니다.

3. 오른쪽 클릭하고 “편집”을 선택합니다. 페이지를 아래로 스크롤하여 “그게 다입니다. 편집을 중지하세요. 행복한 블로깅.”이라는 텍스트를 찾습니다. 그 위에 다음 코드를 추가합니다:

define('WP_MEMORY_LIMIT','256M');

4. “변경 사항 저장”을 클릭하고 파일을 닫습니다.

3. 데이터베이스 연결 오류

이 문제는 워드프레스가 데이터베이스에 연결할 수 없을 때 발생합니다. 데이터베이스에는 웹사이트에 표시되는 모든 미디어와 콘텐츠가 포함되어 있으므로 이 문제가 발생하면 사이트가 오프라인 상태가 됩니다.

MySQL 서버 재시작

cPanel에서 서버 서비스 재시작 옵션을 검색하고 MySQL 서버를 재시작합니다. 이제 웹사이트 연결을 테스트합니다. 문제가 지속되면 다음 단계를 따르세요.

데이터베이스 서버가 실행 중인지 확인

데이터베이스 서버를 재시작한 후에도 여전히 데이터베이스에 연결할 수 없다면, 데이터베이스 서버가 다운되었을 수 있습니다. 이를 확인하려면 cPanel에서 phpMyAdmin 또는 다른 데이터베이스 관리자를 열고 데이터베이스에 연결할 수 있는지 확인합니다. 로그인할 수 없거나 데이터베이스 테이블이 표시되지 않으면 MySQL 서버에 문제가 있을 가능성이 높습니다(재시작해도 복구되지 않음). 즉시 웹 호스트에 연락하세요.

데이터베이스 테이블 존재 여부 확인

데이터베이스 서버가 정상적으로 작동하면 다음으로 워드프레스 테이블이 여전히 존재하는지 확인해야 합니다. 데이터베이스 테이블을 실수로 삭제했거나 손상되었거나 악성 코드/감염된 스크립트가 이를 삭제했을 수 있습니다.

1. cPanel에서 phpMyAdmin을 열고 워드프레스 데이터베이스 테이블을 찾습니다.

2. 존재하는 경우 모든 테이블을 선택하고 “테이블 복구”를 선택합니다.

데이터베이스 사용자 자격 증명 확인

마지막으로 모든 방법이 실패하면 wp-config.php 파일을 확인하여 올바른 데이터베이스 사용자 자격 증명을 입력했는지 확인합니다.

wp-config.php 파일에서 사용자 이름, 데이터베이스 이름, 호스트 및 비밀번호를 확인합니다. 또한 테이블 접두사가 올바른지 확인합니다(기본값은 wp_). 잘못된 경우 오류를 수정하면 웹사이트가 정상으로 돌아옵니다.

4. 워드프레스 대시보드에 접근할 수 없음

이 오류는 상대적으로 흔합니다. 이 문제가 발생하면 워드프레스는 데이터베이스 수리가 필요하다는 메시지를 표시합니다. 대시보드에 접근하려고 할 때마다 이 메시지가 표시됩니다.

1. ‘wp-config.php’ 파일에 다음 코드를 새 줄에 추가합니다:

define('WP_ALLOW_REPAIR',true);

2. “http://www.yourwebsite.com/wpadmin/mait/repair.php”로 이동합니다. (“yourwebsite.com”을 여러분의 웹사이트 URL로 교체하세요.) 수리 프로세스가 시작되어 데이터베이스의 모든 오류를 수정합니다.

3. “wp-config.php” 파일로 돌아가서 2단계에서 추가한 코드를 제거합니다. 이 코드는 누구나 접근할 수 있습니다.

4. 이제 웹사이트가 정상으로 돌아와야 합니다.

문제가 지속되면 결함이 있는 플러그인이나 테마가 원인일 수 있습니다.

1. 플러그인 폴더로 이동합니다. 즉, wp-content로 이동합니다.

2. “plugins” 폴더의 이름을 “plugins_old”로 변경한 다음 새로운 폴더를 만들고 “plugins”로 이름을 지정합니다.

3. 사이트를 테스트합니다. 이제 대시보드에 접근할 수 있다면 결함이 있는 플러그인이 있습니다.

4. 이 플러그인을 추적하려면 다양한 플러그인 파일을 새 플러그인 폴더로 이동합니다. 각 이동 후 대시보드에 접근해 보세요.

5. 결함이 있는 플러그인을 이동하면 대시보드에 접근할 수 없게 됩니다. 즉시 삭제하세요.

결함이 있는 플러그인이 없다면 테마 파일에 대해 동일한 프로세스를 반복합니다.

5. 연결 시간 초과

이 오류의 전형적인 징후는 사이트가 로드하려고 시도한 후 “연결 시간 초과” 메시지가 나타나는 것입니다. 데이터베이스 설정이나 핵심 워드프레스 파일을 변경하지 않았다면, 이는 짜증나는 일입니다.

이 오류의 원인은 간단합니다. 웹사이트가 서버가 처리할 수 있는 것보다 더 많은 요청을 제출하고 있습니다. 다음은 이 오류를 수정하는 해결책입니다.

wp-config.php 파일에서 메모리 한도 늘리기

이 오류의 가장 가능성이 높은 원인은 “PHP 메모리 한도 초과”입니다. 다음 코드를 wp-config.php 파일에 추가하여 PHP의 메모리 한도를 늘릴 수 있습니다:

define('WP_MEMORY_LIMIT','256M');

모든 플러그인 비활성화

워드프레스 플러그인을 비활성화하면 문제를 일으키는 플러그인을 추적하는 데 도움이 될 수 있습니다. 일부 잘못 작성된 플러그인은 상당한 서버 리소스를 소모합니다.

1. 워드프레스 대시보드의 플러그인 섹션으로 이동하여 모든 플러그인을 비활성화합니다.

2. 각 플러그인을 하나씩 천천히 다시 활성화하고 어떤 플러그인이 문제를 일으키는지 확인합니다.

호스트에 업그레이드 요청

때때로 호스팅 계획이 웹사이트 부하를 지원하기에 불충분할 수 있습니다. 이는 호스팅 계획을 업그레이드해야 함을 의미합니다(즉, 호스팅 요구에 더 많은 RAM/메모리가 필요함을 의미합니다).

호스트에 연락하여 웹사이트에 대한 더 광범위한 계획을 요청하세요. 이 업그레이드는 사이트가 더 많은 요청을 처리하고 플러그인으로부터 더 많은 요구를 수용할 수 있게 합니다.

6. 워드프레스 관리자 영역에서 잠김

이 사건은 누구에게나 발생할 수 있습니다. 비밀번호를 잊어버리고 복구 이메일에 접근할 수 없게 되었을 수 있습니다. 이는 실제 상황입니다! 때때로 이는 워드프레스 웹사이트에 대한 해킹 시도의 결과일 수 있습니다. 계정에 대한 접근을 복구하려면 다음 절차를 따르세요.

1. cPanel에서 phpMyAdmin을 엽니다.

2. “데이터베이스”를 클릭하고 워드프레스 웹사이트 데이터베이스를 선택합니다. “wp_users”(또는 사용자 정의 WP 접두사를 사용하는 경우 “Users” 테이블)를 찾습니다. 선택합니다.

2. 이 열에서 워드프레스 사용자 이름을 찾아 “편집”을 선택합니다.

즉시 다음 페이지에서 “user_password” 열을 볼 수 있습니다. 이 열을 편집해야 합니다. 이제 이상한 문자를 새로운 비밀번호로 변경합니다.

옆의 드롭다운 메뉴에서 “MD5”를 선택하여 암호화 기술로 선택합니다. 이는 비밀번호가 공개적으로 표시되지 않도록 하기 위함입니다.

“실행”을 클릭하고 새로운 자격 증명으로 로그인해 보세요.

7. 로그인 페이지가 계속 리디렉션됨

이 경우 웹사이트에 접근할 수 없으며 계속 리디렉션됩니다. 대부분의 경우 로그인 페이지로 다시 리디렉션된 후 잠시 후 연결이 시간 초과됩니다. 이 오류로 인해 웹사이트 대시보드를 볼 수 없습니다. 다음은 이와 같은 워드프레스 문제를 해결하는 방법에 대한 팁입니다.

1. 브라우저 쿠키, 캐시 및 기록을 지우고 다시 시도합니다.

2. 위 방법이 작동하지 않으면 위의 문제 2에서 설명한 해결책을 따릅니다. 이 작업은 새로운 “.htaccess” 파일을 생성합니다. 이제 로그인해 보세요. 대부분의 경우 이 문제를 해결합니다.

3. 위의 해결책 5에서 설명한 대로 모든 플러그인을 비활성화합니다.

wp-config.php 파일 편집

이 시점까지 아무것도 작동하지 않으면 다음을 시도해 보세요:

1. wp-config.php 파일에 다음 코드를 추가합니다:

define(‘WP_HOME','https://yourwebsite.com');  
define(‘WP_SITEURL','https://yourwebsite.com');

변경 사항을 저장하고 다시 로그인해 보세요. 이번에는 작동해야 합니다.

8. 워드프레스가 유지 관리 모드에 갇힘

종종 워드프레스에 새로운 업데이트를 설치해야 할 필요가 있습니다. 이러한 업데이트는 플러그인이나 테마에 대한 것일 수 있습니다. 때때로 워드프레스 자체에 대한 업데이트일 수 있습니다. 걱정하지 마세요. 워드프레스는 이러한 모든 작업을 자동으로 처리하지만 때때로 문제가 발생할 수 있습니다.

이 경우 정기 유지 관리 중에 워드프레스가 갇힙니다. 이 작업을 완료할 수 없으며 웹사이트 대시보드에 접근할 수 없습니다. 사이트는 사용자에게 진행 중인 유지 관리 메시지를 표시합니다.

1. CPanel에 로그인하고 파일 관리자를 엽니다.

2. 루트 디렉토리에서 “.maintenance” 파일을 검색하여 삭제합니다.

이 절차는 문제를 해결해야 합니다. 임시 파일 “.maintenance”가 이 메시지를 표시하는 책임이 있으며, 이를 삭제하면 이 메시지가 제거됩니다.

9. 워드프레스에 이미지 업로드 불가

이 문제가 발생하면 워드프레스에 이미지를 업로드할 수 없습니다. 때때로 업로드가 완료되지만, 다시 로드할 때 깨지거나 누락된 것처럼 보입니다.

문제는 워드프레스의 업로드 폴더에 연결된 권한 때문입니다.

1. CPanel에 로그인합니다. 파일 관리자에 들어갑니다.

2. “public_html” 폴더로 이동합니다. 다음으로 “wp-content” 폴더를 클릭합니다. “uploads” 폴더를 찾습니다.

3. “uploads” 폴더를 오른쪽 클릭하고 “권한 변경”을 클릭합니다. 아래 이미지의 설정을 복제하고 “권한 변경”을 선택하여 저장합니다.

이렇게 하면 업로드 문제가 해결되어야 합니다.

10. 404 오류 수정

게시물/페이지를 의도적으로 삭제한 경우 404 오류는 예상되며 무시할 수 있습니다. 존재해야 하는 페이지에서 404 오류가 발생하면 퍼머링크 문제 때문일 수 있습니다.

1. 워드프레스 대시보드로 이동하여 설정을 클릭한 다음 퍼머링크로 이동합니다.

2. “변경 사항 저장” 버튼을 클릭합니다.

문제가 사라져야 합니다.

위 방법이 작동하지 않으면 호스트 제공업체에 연락하세요. mod_rewrite 규칙을 활성화해 달라고 요청하세요.

결론

위는 워드프레스에서 발생할 수 있는 가장 성가신 문제 중 일부입니다. 따라서 다음에 이러한 문제에 직면했을 때는 당황하지 마세요. 위에서 추천한 해결책을 살펴보고 웹사이트를 되찾으세요. 여러분은 자신의 IT 지원이 되어 워드프레스 문제를 순식간에 해결할 수 있습니다.