# WordPress 하얀 화면 죽음 문제 해결하기

Source: https://support.kapsulehost.com/ko-kr/wordpress-white-screen

"white screen of death(죽음의 백색 화면)"는 WordPress 사이트에 오류 메시지 없이 빈 흰색 페이지만 표시되는 현상입니다. 원인을 알려주는 단서가 전혀 보이지 않기 때문에 가장 당혹스러운 WordPress 문제 중 하나입니다. 이 가이드에서는 가장 흔한 원인과 각각을 해결하는 방법을 살펴봅니다.

### 1단계: 오류 로그 확인

가장 먼저 해야 할 일은 PHP 오류 로그를 확인하는 것입니다. 보통 여기서 정확한 원인을 알 수 있습니다:

1. [kpanel.kapsulehost.com](https://kpanel.kapsulehost.com)에서 KPanel에 로그인합니다
2. **웹사이트**로 이동해 사이트를 선택한 뒤 **로그**를 클릭합니다
3. **PHP 오류 로그**를 엽니다
4. 흰 화면이 시작된 시점 근처의 `Fatal error` 항목을 찾습니다

자세한 내용은 [웹사이트 오류 로그 확인하기](https://support.kapsulehost.com/ko-kr/error-logs)를 참고하세요.

### 2단계: WordPress 디버그 모드 활성화

오류 로그에 충분한 정보가 표시되지 않는다면 WordPress 디버그 모드를 활성화하세요:

1. SFTP 또는 KPanel 파일 관리자를 통해 접속합니다
2. `wp-config.php` 파일을 엽니다
3. 다음과 같이 설정합니다:

```php
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
```

4. 페이지를 새로고침하고 `wp-content/debug.log`에서 오류 메시지를 확인합니다

### 3단계: 모든 플러그인 비활성화

업데이트 후 흰 화면이 발생하는 가장 흔한 원인은 결함이 있거나 호환되지 않는 플러그인입니다.

WordPress 관리자에 접속할 수 있는 경우: **Plugins > Installed Plugins**로 이동해 모두 선택한 뒤 일괄 작업 메뉴에서 **Deactivate**를 선택합니다.

WordPress 관리자에 접속할 수 없는 경우:

1. [SFTP](https://support.kapsulehost.com/ko-kr/sftp-access)를 통해 사이트에 접속합니다
2. `wp-content/plugins/`로 이동합니다
3. `plugins` 폴더 이름을 `plugins-disabled`(으)로 변경합니다
4. 사이트를 다시 불러와 봅니다

흰 화면이 사라지면 플러그인이 원인입니다. 폴더 이름을 다시 `plugins`(으)로 되돌린 뒤, 문제를 일으키는 플러그인을 찾을 때까지 플러그인을 하나씩 비활성화해 보세요.

### 4단계: 기본 테마로 전환

손상된 테마도 흰 화면의 원인이 될 수 있습니다:

1. SFTP를 통해 `wp-content/themes/`로 이동합니다
2. 사용 중인 테마 폴더의 이름을 `mytheme-disabled`처럼 변경합니다
3. 그러면 WordPress가 기본 테마로 대체됩니다

> **Tip:** 문제를 일으킨 플러그인이나 테마를 찾아낸 후에는 개발사에서 업데이트가 제공되는지 확인하세요. 많은 흰 화면 문제가 다음 릴리스에서 수정됩니다.

### 5단계: PHP 메모리 한도 늘리기

WordPress가 [메모리를 모두 소진](https://support.kapsulehost.com/ko-kr/wordpress-memory-limit)하면 흰 화면이 발생할 수 있습니다. 한도를 늘리려면:

1. 파일 관리자 또는 SFTP로 `wp-config.php`을 엽니다
2. `/* That's all, stop editing! */` 줄 앞에 다음 줄을 추가합니다:

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

3. 파일을 저장하고 사이트를 새로고침합니다

KPanel의 **Websites > [해당 사이트] > Settings > PHP**에서도 PHP 메모리 한도를 늘릴 수 있습니다.

### 6단계: 백업에서 복원

위의 단계로도 문제가 해결되지 않는다면, 문제가 시작되기 전에 생성된 백업에서 복원하는 것이 가장 빠른 해결 방법입니다. [백업에서 복원하기](https://support.kapsulehost.com/ko-kr/restoring-from-backup)를 참고하세요.

### 그래도 해결되지 않나요?

이 단계들을 모두 수행한 후에도 흰 화면이 계속된다면 KPanel의 **지원**에서 지원 티켓을 열어주세요. 가장 최근의 PHP 오류 로그 항목과 문제가 발생하기 전 사이트에서 변경된 사항에 대한 설명을 함께 첨부해 주세요.