워드프레스 관리자 화면에서 플러그인을 업데이트한 뒤 사이트를 확인하려고 새로고침했는데 평소 보던 화면 대신 짧은 영어 문구 하나만 나왔다.
Briefly unavailable for scheduled maintenance. Check back in a minute.
처음 봤을 때는 사이트가 아예 고장 난 줄 알았다.
관리자 페이지로 들어가려고 해도 같은 문구가 나오고, 홈페이지도 열리지 않았다. 새로고침을 여러 번 해봤지만 화면은 그대로였다.
오류 메시지에 ‘잠시 후 다시 확인하라’는 내용이 있어서 일단 조금 기다려봤다. 워드프레스가 업데이트되는 동안 잠깐 표시되는 화면일 수도 있다고 생각했기 때문이다.
그런데 시간이 지나도 그대로였다.
그때부터 단순히 업데이트가 진행 중인 게 아니라 유지보수 상태가 정상적으로 종료되지 않은 것 같다는 생각이 들었다.
업데이트할 때 잠깐 나타나는 화면이었다
워드프레스에서 플러그인이나 테마, 워드프레스 자체를 업데이트하면 작업하는 동안 방문자가 사이트의 중간 상태를 보지 않도록 잠시 유지보수 모드로 전환된다.
업데이트가 정상적으로 끝나면 이 상태도 자동으로 풀린다.
그래서 평소에는 유지보수 화면을 볼 일이 거의 없다.
문제는 업데이트 중 브라우저를 닫거나 서버 연결이 끊기는 등 작업이 중간에 멈췄을 때였다.
업데이트는 끝났는데 워드프레스에서는 아직 유지보수 중인 것으로 인식하면 홈페이지에 계속 같은 문구가 남을 수 있다.
내 경우에도 기다리는 것만으로는 해결되지 않았다.
워드프레스 관리자 화면에도 들어갈 수 없었다
처음에는 관리자 페이지에서 업데이트를 다시 실행하면 될 거라고 생각했다.
그래서 주소 뒤에 /wp-admin을 붙여 접속해봤다.
하지만 관리자 페이지에도 같은 유지보수 문구가 나왔다.
이 상태에서는 워드프레스 안에서 문제를 해결할 수 없었다.
결국 워드프레스 관리자 화면이 아니라 호스팅에 저장된 실제 파일을 확인해야 했다.
호스팅 파일 관리자를 열어봤다
내가 사용하는 호스팅 관리 화면에 들어가 파일 관리 기능을 찾았다.
업체에 따라 메뉴 이름은 조금씩 다를 수 있다.
파일 관리자, 웹FTP, 파일 관리, FTP 관리 같은 이름으로 되어 있을 수 있다.
워드프레스가 설치된 폴더로 들어가면 익숙한 폴더들이 보인다.
wp-admin
wp-content
wp-includes
그리고 여러 개의 PHP 파일이 있었다.
이 폴더들이 보인다면 워드프레스가 설치된 위치를 제대로 찾은 것이다.
평소에는 없던 .maintenance 파일을 찾았다
워드프레스 최상위 폴더를 살펴보니 .maintenance라는 파일이 있었다.
파일 이름 앞에 점이 붙어 있어서 처음에는 잘 보이지 않았다.
호스팅 파일 관리자에서 숨김 파일을 표시하지 않는 경우에는 .maintenance가 목록에 안 보일 수도 있다.
이럴 때는 파일 관리 화면에서 숨김 파일 표시와 비슷한 옵션이 있는지 확인하면 된다.
이 파일이 워드프레스가 현재 유지보수 중이라는 것을 알려주는 역할을 한다.
정상적인 업데이트라면 작업이 끝난 뒤 자동으로 없어져야 하지만, 업데이트가 제대로 마무리되지 않으면 파일이 남을 수 있다.
내 사이트에서는 이 파일이 그대로 남아 있었다.
.maintenance 파일만 삭제했다
처음에는 파일 하나를 지워도 되는지 걱정됐다.
워드프레스 폴더에는 중요한 파일이 많기 때문에 잘못 지우면 오히려 더 큰 문제가 생길 수도 있다.
그래서 다른 파일은 건드리지 않고 .maintenance 파일만 확인해서 삭제했다.
특히 이름이 비슷하다고 다른 PHP 파일이나 폴더를 지우면 안 된다.
삭제한 뒤 바로 사이트 주소를 다시 열어봤다.
이번에는 유지보수 문구가 사라지고 원래 워드프레스 화면이 나타났다.
관리자 페이지도 다시 접속할 수 있었다.
생각보다 해결 방법은 간단했지만 관리자 페이지가 완전히 막혀 있었기 때문에 처음 봤을 때는 훨씬 큰 오류처럼 느껴졌다.
사이트가 열렸다고 바로 끝내지는 않았다
홈페이지가 다시 열린 뒤에는 업데이트가 제대로 끝났는지도 확인했다.
유지보수 오류가 생겼다는 것은 직전에 진행하던 업데이트가 완전히 끝나지 않았을 가능성도 있기 때문이다.
관리자 화면에서 플러그인 → 설치한 플러그인으로 들어가 업데이트했던 플러그인의 상태를 확인했다.
업데이트가 남아 있으면 다시 진행했다.
다만 이번에는 여러 개를 한꺼번에 업데이트하기보다 하나씩 처리했다.
업데이트가 끝날 때까지 다른 메뉴로 이동하거나 브라우저 창을 닫지 않고 완료 문구가 나오는 것까지 확인했다.
화면이 깨진 곳도 한 번씩 확인했다
유지보수 모드는 풀렸지만 혹시 업데이트 중 문제가 생긴 부분이 있을 수 있어서 사이트를 몇 군데 직접 열어봤다.
홈페이지가 정상적으로 나오는지 보고, 최근 글도 몇 개 열어봤다.
모바일에서도 접속해보고 이미지와 메뉴가 제대로 표시되는지도 확인했다.
특히 테마나 페이지 빌더 플러그인을 업데이트하다가 문제가 생겼다면 사이트 디자인이 달라질 수도 있어서 겉으로 보이는 부분까지 확인하는 것이 마음이 놓였다.
.maintenance 파일이 안 보이면 기다려보는 게 먼저였다
유지보수 문구가 보인다고 해서 무조건 바로 호스팅에 들어가 파일부터 삭제할 필요는 없다.
실제로 업데이트가 진행 중일 수도 있기 때문이다.
업데이트 버튼을 누른 직후라면 잠시 기다려보는 편이 낫다.
조금 지나서 정상 화면으로 돌아온다면 원래 워드프레스의 업데이트 과정에서 나타난 화면이다.
문제는 충분히 기다렸는데도 계속 같은 문구가 나오고 관리자 페이지까지 접속되지 않는 경우다.
그때 .maintenance 파일이 남아 있는지 확인해보면 된다.
업데이트할 때 여러 개를 한꺼번에 누르지 않게 됐다
이 오류를 겪은 뒤로 플러그인 업데이트 방식도 조금 바꿨다.
예전에는 업데이트가 여러 개 보이면 모두 선택한 다음 한 번에 처리했다.
빠르기는 하지만 중간에 어떤 플러그인에서 문제가 생겼는지 찾기 어렵다.
특히 중요한 사이트라면 업데이트하기 전에 백업을 해두고 플러그인을 몇 개씩 나눠 업데이트하는 편이 마음이 편했다.
업데이트 후에는 바로 홈페이지를 한 번 열어본다.
이렇게 해두면 문제가 생겨도 어떤 업데이트 직후 발생했는지 파악하기 쉽다.
유지보수 오류와 다른 오류를 구분했다
워드프레스가 열리지 않는다고 해서 모두 .maintenance 파일 때문인 것은 아니다.
내가 본 것처럼 화면에 정확히
Briefly unavailable for scheduled maintenance. Check back in a minute.
문구가 나오는 경우라면 유지보수 모드와 관련 있을 가능성이 높다.
반대로 화면이 완전히 하얗게 나오거나 500 오류가 표시되는 경우, 특정 플러그인의 오류 메시지가 나오는 경우라면 원인이 다를 수 있다.
이럴 때 .maintenance 파일만 계속 찾는다고 해결되는 것은 아니다.
오류 화면을 먼저 캡처해두고 어떤 문구가 표시됐는지 확인하는 것이 필요했다.
지금은 업데이트가 끝나는 걸 확인하고 이동한다
이번 오류는 사이트가 사라진 것도 아니었고 워드프레스를 다시 설치해야 하는 문제도 아니었다.
업데이트 과정에서 만들어진 유지보수 파일이 정상적으로 지워지지 않아 사이트가 계속 유지보수 상태로 남아 있었던 것이었다.
.maintenance 파일을 삭제하니 사이트는 바로 다시 열렸다.
한 번 겪고 나니 다음에 같은 문구가 나온다고 해도 예전처럼 당황하지 않을 것 같다.
지금은 업데이트를 시작하면 작업이 끝났다는 화면이 나올 때까지 기다리고, 업데이트 직후에는 홈페이지와 관리자 화면을 한 번씩 확인한다.
워드프레스에서는 아주 작은 파일 하나 때문에 사이트 전체가 안 열리는 것처럼 보일 수도 있다는 걸 이때 처음 알았다.
답글 남기기