흰 화면은 대개 PHP 치명 오류입니다. 처리 중에 실행이 멈추면서 아무것도 출력되지 않은 상태이고, 브라우저는 빈 응답을 그대로 그립니다. 상태 코드는 200 이거나 500 입니다.
정보가 없는 것처럼 보이지만 실은 정보가 감춰져 있습니다. 프로덕션 기본값이 에러를 화면에 표시하지 않도록 되어 있기 때문이고, 그 기본값은 옳습니다 — 우리가 할 일은 그것을 끄는 것이 아니라 목적지를 파일로 바꾸는 것입니다.
1. 로그를 켭니다 — 화면이 아니라 파일로
wp-config.php 의 /* That's all, stop editing! */ 줄 위에 넣습니다. 세 줄이 한 세트이고, 마지막 줄이 가장 중요합니다.
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true ); // wp-content/debug.log 로 기록
define( 'WP_DEBUG_DISPLAY', false ); // 화면에는 절대 출력하지 않는다
화면 출력을 켜면 안 되는 이유는 두 가지입니다. 첫째, 에러 메시지에는 서버의 절대 경로 · 데이터베이스 이름 · 함수 호출 흐름이 그대로 들어 있어 공격자에게 지도를 건네는 것과 같습니다. 둘째, 그 화면을 방문자와 검색엔진이 봅니다.
2. 로그 파일을 웹에서 읽히지 않게 합니다
wp-content/debug.log 는 기본적으로 웹에서 주소로 열립니다. 방금 화면 노출을 막아 놓고 같은 내용을 공개 주소에 두는 셈이라, 디버그를 켤 때는 접근 차단을 함께 합니다. nginx 라면 서버 설정에서 .log 를 막고, 가능하다면 로그 경로 자체를 문서 루트 밖으로 옮깁니다.
location ~* .(log|sql|bak)$ { deny all; }
그리고 원인을 찾은 뒤에는 반드시 되돌립니다. 디버그를 켠 채 잊고 지나가는 일이 아주 흔한데, 로그 파일이 계속 자라 디스크를 채우고 그것이 다음 장애가 됩니다 — 5회차에서 다룰 바로 그 장애입니다.
3. 로그의 마지막 줄부터 읽습니다
파일이 길어도 볼 곳은 정해져 있습니다. 장애가 시작된 시각의 Fatal error 한 줄입니다. 그 줄에는 대개 오류 종류와 파일 경로가 함께 있고, 경로가 곧 범인을 가리킵니다.
메시지에 Allowed memory size 가 보이면 메모리 한도입니다. 한도를 올려 일단 복구할 수는 있지만, 어제까지 되던 사이트가 오늘 한도를 넘겼다면 무언가가 갑자기 많이 먹기 시작한 것이므로 원인을 따로 봅니다. 한도 상향은 임시 조치이지 해결이 아닙니다.
관리자 화면조차 열리지 않는다면 워드프레스가 보내는 복구 모드 메일을 확인하세요. 코어가 치명 오류를 감지하면 관리자 메일로 원인 플러그인 이름과 복구 모드 링크를 보냅니다 — 이 메일이 도착하려면 메일 발송이 정상이어야 하고, 그래서 발송 경로 점검은 장애 대응 준비의 일부입니다.
이런 설정을 사고 전에 갖춰 두는 방법은 서버 · 인프라 아카이브에 정리돼 있고, 로그 · 권한 · 캐시 구성을 한 번에 정비하고 싶다면 최적화 지원 사업에 포함됩니다.
다음 회차
로그를 켰더니 이번에는 로그가 여러 개입니다. 다음 회차는 PHP · 웹서버 · MySQL 로그가 각각 무엇을 말하는지, 어떤 순서로 읽어야 하는지입니다.