[워드프레스 팁] 플러그인 업데이트 후 Briefly unavailable for scheduled maintenance 오류 해결법

워드프레스에서 새로운 플러그인을 설치하거나 기존 플러그인을 업데이트하는 도중, 갑자기 사이트 화면에 “Briefly unavailable for scheduled maintenance. Check back in a minute.”라는 영어 문구가 뜬 채 페이지가 먹통이 되는 현상을 겪으신 적이 있으실 겁니다. 몇 분이 지나도 화면이 멈춰 있고 관리자 페이지(wp-admin)조차 접속되지 않아 크게 당황하셨을 텐데요.

다행히 이 현상은 서버나 데이터베이스가 파손된 중대한 고장이 아니라, 워드프레스 시스템이 업데이트 도중 진행 상태를 보호하기 위해 자동 생성한 일시 정지 파일(.maintenance)이 업데이트 완료 후 제대로 자동 삭제되지 못하고 남아있어서 발생하는 단순 해프닝입니다.

오늘은 이 오류가 왜 발생했는지 그 원인을 알아보고, FTP 프로그램이나 호스팅 파일 관리자를 통해 몇 초 만에 사이트를 원상 복구하는 방법과, 복구 후 발생할 수 있는 ‘치명적인 오류(Critical Error)’ 대처법까지 깔끔하게 정리해 드리겠습니다.

1. 유지보수 모드 문구가 뜨는 원인과 .maintenance 파일이란?

워드프레스는 플러그인, 테마, 코어 시스템을 업데이트할 때 사이트 방문자가 업데이트 중간 상태의 미완성 페이지를 보거나 데이터 오류가 발생하는 것을 막기 위해 자동으로 유지보수 모드(Scheduled Maintenance Mode)를 실행합니다.

업데이트가 시작되는 순간, 워드프레스 설치 최상위 디렉토리에 .maintenance라는 숨김 임시 파일이 자동으로 생성됩니다. 정상적인 경우라면 업데이트가 마무리되자마자 이 임시 파일이 자동으로 싹 삭제되면서 방문자 화면이 정상으로 돌아옵니다.

하지만 다음과 같은 상황이 발생하면 임시 파일이 삭제되지 못하고 계속 갇혀 남아있게 됩니다.

• 업데이트 도중 인터넷 연결이 끊기거나 브라우저 탭을 너무 빨리 닫아버린 경우
• 웹 호스팅 서버의 PHP 처리 시간(Max Execution Time)이나 메모리 제한이 초과되어 업데이트 작업이 도중에 멈춘 경우
• 설치하려는 플러그인 파일의 용량이 커서 다운로드 스트리밍 중 타임아웃 오류가 난 경우
• 여러 개의 플러그인을 ‘일괄 업데이트’ 누른 후 작업 처리가 엉킨 경우

결국 서버에 .maintenance 파일이 계속 남아있는 한, 워드프레스는 사이트가 여전히 업데이트 중이라고 판단하여 방문자와 관리자 모두에게 해당 안내 페이지를 계속 보여주는 것입니다.

2. 호스팅 파일 관리자 및 FTP로 .maintenance 파일 삭제하는 3단계 방법

이 문제를 해결하는 방법은 아주 명쾌합니다. 서버에 홀로 남아있는 .maintenance 파일만 직접 찾아서 삭제해 주면 사이트는 그 즉시 원상태로 맑게 복구됩니다. 워드프레스 웹 관리자 창이 열리지 않는 상태이므로 호스팅 서버에 직접 파일로 접속해야 합니다.

1. FTP 프로그램 또는 호스팅 파일 관리자(File Manager) 접속하기

   가장 익숙한 접속 방식을 선택합니다. 카페24, 가비아, 클라우드웨이즈(Cloudways) 등 이용 중인 호스팅업체 홈페이지에 로그인한 후 제공되는 ‘웹 파일 관리자(File Manager)’ 기능에 접속하거나, 컴퓨터에 설치된 FileZilla(파일질라) 같은 FTP 프로그램을 실행하여 서버 IP, FTP 아이디, 비밀번호, 포트 번호를 입력하고 접속합니다.

2. 워드프레스 최상위 루트 디렉토리 이동하기

   서버에 접속하면 워드프레스 파일들이 모여있는 최상위 루트 폴더로 이동해야 합니다. 호스팅 환경에 따라 폴더 이름이 조금씩 다를 수 있으나, 일반적으로 public_html, www, html 또는 해당 도메인 이름으로 된 폴더입니다. 해당 폴더 안으로 진입하면 wp-config.php, wp-content, wp-includes 등의 핵심 파일들이 보입니다.

3. .maintenance 숨김 파일 찾아 삭제하기

   루트 폴더 내부 목록에서 .maintenance 파일만 선택하여 마우스 우클릭 후 [삭제(Delete)]를 진행합니다.

   *주의: 파일명 앞에 점(.)이 붙은 파일은 시스템 숨김 파일(Dotfiles)로 취급됩니다. 만약 폴더 내부에서 해당 파일이 보이지 않는다면, 웹 파일 관리자 우측 상단 설정 아이콘에서 ‘숨김 파일 보기(Show Hidden Files / Dotfiles)’ 체크박스를 활성화하거나, 파일질라 상단 메뉴의 [서버] > [숨김 파일 강제 표시] 옵션을 켜야 나타납니다.

삭제를 완료한 후 사용 중인 브라우저로 돌아와 사이트 주소를 새로고침(F5) 해보세요. 안내 문구가 깔끔하게 사라지고 사이트가 곧바로 정상화되는 모습을 확인하실 수 있습니다.

3. 파일 삭제 후 ‘치명적인 오류(Critical Error)’가 발생할 때 해결법

만약 .maintenance 방화벽 파일을 삭제한 뒤 사이트를 새로고침했는데, 이번에는 “이 웹사이트에 치명적인 오류가 있습니다 (There has been a critical error on this website)”라는 영문 또는 한글 문구가 뜨면서 접속이 안 되는 경우도 있습니다.

이것은 유지보수 파일 삭제 문제가 잘못된 것이 아니라, 방금 업데이트하거나 새로 설치하려 했던 특정 플러그인 내부 코드가 사용 중인 워드프레스 코어 버전이나 다른 플러그인, 또는 PHP 버전과 서로 강하게 충돌(Conflict)을 일으켰음을 의미합니다.

이럴 때는 충돌을 유발한 플러그인을 아래와 같이 강제로 비활성화해주시면 즉시 해결됩니다.

1. plugins 디렉토리로 이동하기

   FTP 또는 웹 파일 관리자에서 wp-content 폴더 안으로 들어간 후, 그 내부에 있는 plugins 폴더로 이동합니다. 이곳에는 현재 블로그에 설치된 모든 플러그인 이름의 폴더가 나열되어 있습니다.

2. 충돌 원인 플러그인의 폴더 이름 변경하기

   방금 설정을 변경했거나 설치/업데이트했던 플러그인의 폴더명을 찾습니다. 해당 폴더를 마우스 우클릭하여 [이름 변경(Rename)]을 선택한 뒤, 폴더 이름 뒤에 _bak 또는 _temp와 같은 임의의 글자를 붙여 변경합니다. (예: my-plugin → my-plugin_bak)

   폴더 이름이 바뀌면 워드프레스 시스템은 해당 플러그인을 찾을 수 없게 되면서 부팅 시 해당 플러그인을 자동으로 비활성화(Deactivate) 처리하게 됩니다.

3. 관리자 페이지 재접속 및 상태 확인하기

   다시 인터넷 브라우저로 wp-admin 주소에 접속해 보면 충돌 화면이 없어지고 깔끔하게 관리자 로그인 창이 열립니다. 로그인 후 [플러그인] > [설치된 플러그인] 메뉴에 들어가면 “해당 파일이 없어 플러그인이 비활성화되었습니다”라는 메시지가 뜨며 나머지 사이트는 모두 정상을 찾습니다.

4. 워드프레스 유지보수 오류 방지를 위한 3가지 실전 관리 팁

업데이트 도중 먹통이 되는 유지보수 모드 갇힘 현상은 약간의 주의만 기울이면 충분히 사전에 예방할 수 있습니다.

• 플러그인은 하나씩 순차적으로 업데이트하기: 관리자 화면에서 ‘전체 선택 후 일괄 업데이트’를 누르면 서버 메모리와 CPU 부담이 급증하여 타임아웃이 발생하기 쉽습니다. 가급적 목록에서 하나씩 클릭하여 완료를 확인하며 업데이트하세요.
• 업데이트 진행 중 브라우저 창 닫지 않기: 상단 로딩 상태 표시줄이 완전히 끝나고 성공 메시지가 뜰 때까지 페이지를 이탈하거나 새로고침을 누르지 마세요.
• PHP 실행 시간 및 메모리 한도 상향하기: 호스팅 관리판 또는 wp-config.php 파일에 메모리 리밋(define('WP_MEMORY_LIMIT', '256M');)을 충분히 설정해 두면 업데이트 도중 멈추는 불상사를 줄일 수 있습니다.

5. 자주 묻는 질문 (FAQ)

Q1. .maintenance 파일이 파일 관리자에서 전혀 보이지 않아요.

파일명 시작 부분에 점(.)이 붙은 파일은 리눅스 및 아파치 서버 환경에서 숨김 파일(Dotfiles)로 처리됩니다. 파일 관리자 설정 화면에서 ‘숨김 파일 표시(Show Hidden Files)’ 항목을 체크하시거나, FTP 프로그램(FileZilla)의 경우 메뉴바에서 [서버] > [숨김 파일 강제 표시]를 활성화하셔야 목록에 나타납니다.

Q2. .maintenance 파일이 삭제되지 않고 권한 오류(Permission Denied)가 납니다.

웹서버의 파일 소유 권한 문제일 수 있습니다. 파일 퍼미션(Permission)을 644 또는 755로 변경한 후 삭제를 재시도해 보시거나, 호스팅 업체 1:1 문의를 통해 파일 소유자 권한 조정을 요청하시면 쉽게 삭제할 수 있습니다.

Q3. 충돌 난 플러그인 폴더 이름을 바꾼 후에는 어떻게 조치해야 하나요?

정상 접속 확인 후 wp-admin 관리자 페이지의 [플러그인] 메뉴에서 이름이 바뀐 이전 플러그인을 삭제하세요. 그 후 개발사 웹사이트나 공식 저장소에서 해당 플러그인의 최신 버전을 다운로드하여 재설치하거나 대체 플러그인을 찾아 설치하시면 됩니다.

요약 및 마무리

워드프레스 플러그인 업데이트 중 발생한 “Briefly unavailable for scheduled maintenance” 오류는 당황할 필요 없이 서버의 .maintenance 파일 삭제만으로 간단히 원상 복구할 수 있는 단순한 현상입니다. 만약 파일 삭제 후에도 접속이 불안정하다면 wp-content/plugins 디렉토리에서 관련 플러그인 폴더의 이름을 변경하여 비활성화하는 방식으로 빠르게 대처할 수 있습니다.

평소 플러그인 개수를 최소한으로 유지하고 하나씩 차근차근 업데이트하는 습관을 들이신다면 쾌적하고 안정적인 블로그 운영을 지속하실 수 있습니다.