워드프레스를 운영하다 보면 플러그인이나 테마, 워드프레스 코어(본체) 업데이트 알림이 자주 뜹니다. 그런데 업데이트 버튼을 누른 직후, 진행률이 다 끝나기도 전에 무심코 다른 메뉴를 클릭하거나 뒤로 가기를 누르는 경우가 있습니다.
바로 이 순간, 사이트 전체가 다음과 같은 화면으로 멈춰버리는 일이 발생합니다.
“워드프레스 웹사이트가 정기 유지 관리 중입니다. 불편을 끼쳐드려 죄송합니다. 잠시후 다시 방문하세요!”
(Maintenance mode is on, Site will be available soon. Thank you for your patience!)
문제는 이 화면이 뜬 뒤로 아무리 새로고침을 하고, 몇 분을 기다리고, 심지어 몇 시간을 기다려도 전혀 풀리지 않는다는 점입니다. 관리자 페이지(wp-admin)조차 접속이 안 되고, 방문자에게도 사이트 전체가 이 점검 화면만 보이게 됩니다.
당황해서 호스팅사 고객센터에 문의하면, 상담원이 cPanel의 파일관리자에서 파일 하나를 삭제해주고 나면 거짓말처럼 사이트가 바로 정상으로 돌아옵니다. 이 글에서는 그 파일의 정체와, 직접 해결하는 방법, 그리고 애초에 이런 상황을 만들지 않는 예방법까지 자세히 정리했습니다.
1. 원인 — .maintenance 파일이 삭제되지 않고 남아있기 때문
1-1. 워드프레스가 업데이트 중에 벌어지는 일
워드프레스는 플러그인, 테마, 코어를 업데이트할 때 다음과 같은 절차를 거칩니다.
- 사이트 최상위 폴더(루트 디렉토리)에 **
.maintenance**라는 이름의 임시 파일을 자동으로 생성합니다. - 이 파일이 존재하는 동안에는 워드프레스가 모든 방문자와 관리자에게 “점검 중” 화면을 강제로 띄웁니다. 업데이트 도중 사이트 파일이 불완전한 상태로 노출되는 것을 막기 위한 정상적인 안전장치입니다.
- 업데이트 작업이 끝나면, 워드프레스가 이
.maintenance파일을 자동으로 삭제하고 사이트를 원래 상태로 되돌립니다.
즉, 이 점검 화면 자체는 업데이트 중에 잠깐 나타났다가 사라지는 것이 정상이며, 보통은 몇 초에서 길어야 1분 이내에 끝납니다.
1-2. 문제가 생기는 시점
문제는 3번 과정, 즉 “자동 삭제” 단계가 제대로 실행되지 못할 때 발생합니다. 아래와 같은 상황에서 흔히 벌어집니다.
- 업데이트가 진행되는 도중에 다른 관리자 메뉴를 클릭해서 페이지를 이동한 경우
- 업데이트 화면에서 브라우저의 뒤로 가기 버튼을 누른 경우
- 업데이트 진행 중에 브라우저 탭을 닫거나 새로고침한 경우
- 여러 플러그인을 한꺼번에 일괄 업데이트하는 도중 서버 응답이 느려지거나 순간적으로 인터넷 연결이 끊긴 경우
- 서버 자체의 처리 속도 문제로 업데이트 스크립트가 시간 초과(timeout)된 경우
이렇게 업데이트 프로세스가 중간에 끊기면, 실제로는 플러그인이나 코어 파일 업데이트 자체는 이미 끝났음에도 불구하고 .maintenance 파일만 삭제되지 못한 채로 서버에 그대로 남습니다. 워드프레스 입장에서는 이 파일이 있는 한 “아직 업데이트 중”이라고 판단하기 때문에, 실제 작업은 끝났는데도 점검 화면이 영원히 풀리지 않는 상태가 되는 것입니다.
2. 해결 방법 — cPanel에서 .maintenance 파일 직접 삭제하기
관리자 페이지 자체가 막혀 있으므로, 워드프레스 화면이 아니라 **호스팅사의 파일관리자(File Manager)**를 통해 서버에 직접 접속해서 해결해야 합니다.
2-1. cPanel(또는 호스팅 관리자 패널) 접속
가입하신 호스팅사의 관리자 페이지(cPanel, 카페24, 가비아 등)에 로그인한 뒤 “파일” 또는 “Files” 섹션의 “File Manager” 아이콘을 클릭합니다.
2-2. 워드프레스 설치 폴더로 이동
워드프레스가 설치된 폴더로 이동합니다. 보통 public_html 폴더이며, wp-config.php, wp-login.php 같은 파일들이 보이는 바로 그 위치입니다.
2-3. 숨김 파일 표시 켜기 — 가장 중요한 단계
.maintenance 파일은 파일명이 마침표(.)로 시작하는 **숨김 파일(dotfile)**입니다. 기본 설정에서는 File Manager 목록에 보이지 않으므로, 반드시 숨김 파일 표시 옵션을 켜야 합니다.
- cPanel 기준: File Manager 접속 화면에서 오른쪽 상단의 “Settings”(설정) 버튼을 클릭한 뒤, “Show Hidden Files (dotfiles)” 항목에 체크하고 저장합니다.
- 이 옵션을 켜면 파일 목록에 이름이 점으로 시작하는 파일들(
.htaccess,.maintenance등)이 추가로 나타납니다.
2-4. .maintenance 파일 삭제
폴더 안에서 .maintenance 파일을 찾아 마우스 우클릭한 뒤 **”Delete”(삭제)**를 선택합니다.
2-5. 사이트 재확인
삭제가 끝나면 별도의 재시작이나 대기 없이, 브라우저에서 사이트 주소를 다시 열어보면 즉시 정상 화면으로 돌아온 것을 확인할 수 있습니다.
💡 참고: 만약 파일이 안 보이거나 File Manager 자체가 익숙하지 않다면, 호스팅사 고객센터 채팅으로 “업데이트 중 사이트가 점검 화면에서 멈췄습니다. .maintenance 파일 삭제를 도와주세요”라고 요청하셔도 됩니다. 대부분의 호스팅사는 이 요청을 매우 흔하게 받기 때문에 즉시 처리해줍니다.
3. 사전 예방 — 애초에 이런 상황을 만들지 않는 습관
.maintenance 파일 문제는 한 번 원인을 알고 나면 해결 자체는 매우 간단하지만, 가장 좋은 방법은 애초에 이 상황을 겪지 않는 것입니다. 아래 습관을 들이시길 권해드립니다.
3-1. 업데이트 중에는 절대 다른 곳을 클릭하지 않는다
플러그인이나 테마, 코어 업데이트 버튼을 누른 뒤에는 “업데이트 완료” 또는 성공 메시지가 화면에 뜰 때까지 다른 메뉴를 클릭하지 말고 그대로 기다려야 합니다. 특히 여러 개를 한꺼번에 선택해서 일괄 업데이트할 때 이런 실수가 자주 발생합니다.
3-2. 플러그인은 한 번에 하나씩, 여유를 두고 업데이트한다
여러 플러그인을 동시에 체크해서 일괄 업데이트하면 서버에 부담이 커져 처리 시간이 길어지고, 그 사이에 자리를 비우거나 다른 작업을 하게 될 가능성이 높아집니다. 특히 중요한 사이트라면 플러그인을 하나씩, 순서대로 업데이트하고 매번 정상 작동을 확인하는 습관이 안전합니다.
3-3. 트래픽이 적은 시간대에 업데이트한다
방문자가 몰리는 시간에 업데이트를 진행하면 서버 부하가 커져 업데이트 프로세스 자체가 느려지거나 시간 초과될 위험이 있습니다. 새벽 시간대 등 트래픽이 적은 때에 정기적으로 업데이트하는 것이 안전합니다.
3-4. 업데이트 전에는 항상 백업을 해둔다
.maintenance 파일 문제는 대부분 파일 하나만 지우면 해결되는 비교적 가벼운 문제지만, 드물게 업데이트 도중 파일이 손상되는 더 심각한 경우도 있습니다. 플러그인이나 코어 업데이트 전에는 백업 플러그인(UpdraftPlus 등)이나 호스팅사의 자동 백업 기능으로 미리 백업해두는 습관을 들이면, 어떤 상황에서도 안심할 수 있습니다.
4. 자주 묻는 질문 (FAQ)
Q. .maintenance 파일을 지우면 진행 중이던 업데이트 내용도 사라지나요?
A. 아닙니다. 이 파일은 단순히 “점검 중” 화면을 띄우는 표시 파일일 뿐, 실제 플러그인이나 코어 파일과는 무관합니다. 이미 업데이트가 끝난 상태에서 이 파일만 남은 것이므로, 삭제해도 업데이트된 내용은 그대로 유지됩니다.
Q. 파일을 지웠는데도 점검 화면이 계속 뜬다면요?
A. 브라우저 캐시 때문일 수 있으니 시크릿(프라이빗) 창으로 다시 접속해보세요. 그래도 안 된다면 .maintenance 파일이 아니라 실제로 업데이트가 중간에 실패해서 플러그인이나 코어 파일 자체가 손상되었을 가능성이 있으므로, 호스팅사에 에러 로그 확인을 요청하는 것이 좋습니다.
Q. 이 파일이 안 보이는데 왜 그런가요?
A. 파일명이 점(.)으로 시작하는 숨김 파일이기 때문입니다. File Manager의 “Show Hidden Files” 옵션을 반드시 켜야 목록에 나타납니다.
결론 — 당황하지 말고 파일 하나만 지우면 끝난다
워드프레스 업데이트 중 사이트가 “워드프레스 웹사이트가 정기 유지 관리 중입니다” 화면에서 멈춰버리는 현상은, 알고 보면 .maintenance라는 임시 파일 하나가 정상적으로 삭제되지 못해서 생기는 단순한 문제입니다.
- 원인: 업데이트 도중 페이지 이동이나 연결 끊김으로
.maintenance파일이 남음 - 해결: cPanel File Manager에서 숨김 파일 표시를 켜고
.maintenance파일을 삭제 - 예방: 업데이트 중 다른 메뉴를 클릭하지 않기, 플러그인을 하나씩 업데이트하기, 업데이트 전 백업하기
이 원인만 알아두시면 앞으로 비슷한 화면을 마주해도 당황하지 않고 몇 분 안에 스스로 해결하실 수 있습니다. 워드프레스를 직접 운영하시는 분이라면 꼭 기억해두시기를 권해드립니다.
