WordPress 오류

이 오류 카테고리 소개

# WordPress 오류

WordPress 장애는 빈 페이지, 500 Internal Server Error, 명시적인 데이터베이스 메시지 또는 PHP 메모리 고갈 알림으로 나타날 수 있습니다. 이러한 증상이 모두 같은 문제를 의미하는 것은 아닙니다. 먼저 방문자에게 정확히 무엇이 표시되는지, WordPress 대시보드에 어떤 내용이 보고되는지, 장애가 발생하기 전에 무엇이 변경되었는지 기록하세요.

이 카테고리의 가이드를 사용해 눈에 보이는 증상과 WordPress 스택에서 문제가 발생했을 가능성이 가장 높은 부분을 연결해 보세요. 플러그인 업데이트 직후 발생한 장애는 데이터베이스 연결 메시지나 Allowed memory size ... exhausted 오류와 다른 방식으로 우선 점검해야 합니다. 여러 구성 요소를 한 번에 변경하지 마세요. 통제된 테스트를 수행하면 원인을 더 쉽게 파악하고 문제가 다시 발생하는 것을 방지할 수 있습니다.

일반적인 WordPress 오류 패턴

플러그인 업데이트 후 500 오류

플러그인 업데이트 직후 500 Internal Server Error가 발생했다면 해당 플러그인을 우선 의심해야 합니다. 업데이트로 인해 PHP 호환성 문제가 드러났거나 활성 테마, 다른 플러그인 또는 호스팅 환경과 충돌했을 수 있습니다.

가장 유용한 확인 방법은 사용 가능한 복구 방법으로 업데이트된 플러그인을 비활성화하거나 이전 버전으로 되돌린 다음, 문제가 발생한 요청을 테스트하는 것입니다. 사이트가 복구되면 PHP 오류 세부 정보를 검토하고, 현재 테마 및 다른 플러그인 조합에서 해당 플러그인 버전을 테스트하세요. 모든 500 응답이 호스트 때문에 발생한다고 단정하지 마세요.

자세한 진단은 [WordPress 플러그인 업데이트 후 500 오류](/wordpress-500-error-after-plugin-update)를 참고하세요.

WordPress 화이트 스크린 오브 데스

화이트 스크린 오브 데스는 유용한 오류가 표시되지 않는 완전히 빈 응답입니다. 방문자에게 PHP 치명적 오류가 숨겨져 있을 때 자주 발생합니다. 빈 페이지만으로는 문제가 플러그인, 테마, PHP 작업, 메모리 제한 또는 손상된 WordPress 파일 중 무엇인지 확인할 수 없습니다.

다음 단계는 가능한 경우 방문자에게 오류가 표시되지 않도록 설정한 상태에서 WordPress 디버깅 또는 호스팅 환경을 통해 근본 오류를 찾는 것입니다. 메시지에서 특정 구성 요소나 작업을 확인했다면 해당 원인만 비활성화하거나 복원 또는 수정한 후 다시 테스트하세요. 빈 페이지를 자동으로 데이터베이스 장애로 간주해서는 안 됩니다.

진단 순서는 [WordPress 화이트 스크린 오브 데스](/wordpress-white-screen-of-death)를 참고하세요.

데이터베이스 연결 설정 오류

Error Establishing a Database Connection 메시지는 WordPress가 MySQL 또는 MariaDB 데이터베이스에 연결하지 못했다는 의미입니다. 변경하기 전에 원래 값을 기록한 뒤 wp-config.php의 데이터베이스 이름, 사용자 이름, 비밀번호 및 호스트 값을 확인하세요.

설정이 올바른 것으로 보인다면 호스팅 환경에서 데이터베이스 서비스에 접근할 수 있는지, 데이터베이스 사용자에게 필요한 권한이 여전히 있는지 확인하세요. 테이블 손상도 가능한 원인이지만, 데이터베이스 복구는 연결 및 구성 확인 후에 진행해야 합니다. 복구 작업을 변경하기 전에 사용 가능한 백업을 보호하세요.

단계별 분석은 [WordPress: 데이터베이스 연결 설정 오류](/wordpress-error-establishing-a-database-connection)를 참고하세요.

WordPress 메모리 고갈 오류

Allowed memory size of X bytes exhausted와 같은 오류는 PHP 프로세스가 설정된 memory_limit보다 많은 메모리를 사용했다는 의미입니다. 사용 가능한 제한을 늘리면 요청이 완료될 수 있지만, 메모리 사용량이 증가한 이유까지 설명해 주지는 않습니다.

플러그인 또는 테마 변경, 가져오기, 백업, 미디어 작업 또는 기타 리소스를 많이 사용하는 작업 중에 오류가 시작되었는지 확인하세요. 사이트에 적용되는 메모리 설정을 검토하고 오류 세부 정보를 통해 관련 요청 또는 구성 요소를 파악하세요. 같은 작업에서 메모리 고갈이 반복된다면 제한을 계속 높이기보다 리소스를 많이 사용하는 작업을 조사해야 합니다.

즉각적인 해결 방법과 장기적인 진단은 [WordPress 메모리 고갈 오류](/wordpress-memory-exhausted-error)를 참고하세요.

실용적인 WordPress 오류 진단 절차

1. 정확한 증상을 기록합니다. 메시지, HTTP 상태, 영향을 받는 URL 또는 작업, 페이지가 비어 있는지 여부, 대시보드를 계속 사용할 수 있는지를 기록하세요.
2. 발생 시점을 확인합니다. 최근 플러그인 또는 테마 업데이트, WordPress 또는 PHP 변경, 구성 편집, 마이그레이션, 가져오기, 백업 또는 호스팅 이벤트가 있었는지 확인하세요.
3. PHP, 애플리케이션 및 데이터베이스 증상을 구분합니다. PHP 치명적 오류 메시지, 빈 페이지 및 500 응답은 직접적인 데이터베이스 연결 오류와 다른 지점에서 진단을 시작해야 함을 의미합니다.
4. 로그 또는 디버깅 출력을 확인합니다. 일반적인 브라우저 오류보다 구성 요소 이름, PHP 파일, 작업 및 전체 오류 메시지가 더 유용합니다.
5. 가능성이 높은 원인을 한 번에 하나씩 테스트합니다. 발생 시점과 가장 밀접한 구성 요소를 비활성화하거나 이전 상태로 되돌린 다음, 실패한 요청을 다시 수행하세요.
6. 공개 기능과 관리 기능을 모두 확인합니다. 홈페이지가 작동한다고 해서 로그인, 게시, 폼, 가져오기 또는 다른 영향을 받은 요청까지 정상이라는 의미는 아닙니다.
7. 성공한 변경 사항을 문서화합니다. 다른 업데이트나 구성 변경을 시도하기 전에 무엇을 되돌리거나 조정했는지 기록하세요.

피해야 할 사항

• 원인을 분리해야 한다면 모든 플러그인을 비활성화하고 테마를 동시에 변경하지 마세요.
• 500 응답이 호스팅 서버를 사용할 수 없다는 의미라고 단정하지 마세요. WordPress 코드도 500 오류를 발생시킬 수 있습니다.
• 메모리를 사용하는 작업을 파악하지 않은 채 PHP 메모리를 반복해서 늘리지 마세요.
• 원래 값을 보존하고 사용 가능한 백업을 고려하지 않은 채 데이터베이스 설정을 덮어쓰지 마세요.
• 필요한 시간보다 오래 상세한 PHP 오류를 방문자에게 노출하지 마세요.
• 브라우저 새로 고침을 진단으로 간주하지 마세요. 로그, 통제된 테스트 및 정확한 오류 메시지가 더 강력한 근거를 제공합니다.

방문자 또는 관리자가 보는 증상과 가장 일치하는 가이드부터 시작하세요. 목표는 페이지를 복구하는 것뿐 아니라 잘못된 업데이트, 숨겨진 PHP 치명적 오류, 데이터베이스 액세스 문제 및 리소스 제한을 구분하여 근본적인 장애를 안전하게 해결하는 것입니다.