워드프레스 업데이트 오류는 코어, 플러그인이나 테마를 업데이트한 직후 나타날 수 있다. 사이트 디자인이 무너지거나 메뉴가 사라지고, 관리자 페이지에 치명적인 오류가 표시될 때도 있다. 방문자 화면은 열리지만 글 편집기나 특정 기능만 작동하지 않는 경우도 있다.
워드프레스 업데이트 오류가 나타났다고 해서 사이트의 글과 이미지가 모두 삭제된 것은 아니다. 업데이트된 파일과 기존 테마 또는 플러그인의 코드가 맞지 않거나 캐시에 이전 파일이 남아 화면이 깨져 보이는 경우가 많다.
이때 업데이트 파일을 바로 삭제하거나 데이터베이스를 수정하면 복구가 더 어려워질 수 있다. 캐시, 최근 업데이트 항목, 복구 이메일처럼 되돌리기 쉬운 부분부터 확인해야 한다.
이 글에서는 워드프레스 업데이트 오류로 깨진 사이트를 안전하게 복구하는 4가지 방법을 정리한다.
워드프레스 업데이트 오류는 왜 생길까?
워드프레스 사이트는 코어, 테마, 플러그인과 PHP가 함께 작동한다. 이 가운데 하나만 새로운 버전으로 바뀌어도 기존 코드와 맞지 않으면 오류가 발생할 수 있다.
대표적인 원인은 다음과 같다.
- 업데이트된 플러그인과 기존 테마의 충돌
- 현재 PHP 버전을 지원하지 않는 새 코드
- 업데이트 도중 끊긴 파일 전송
- 서버 캐시나 브라우저에 남은 이전 파일
- 테마의 사용자 정의 코드와 새 버전의 충돌
- 서버 메모리나 디스크 용량 부족
업데이트 직전에 어떤 항목을 변경했는지 기록하면 원인을 좁히기 쉽다. 워드프레스 본체, 플러그인, 테마를 한꺼번에 업데이트했다면 확인 과정이 길어질 수 있다.
1. 캐시를 비우고 깨진 범위를 확인한다
사이트가 열리지만 디자인만 깨졌다면 캐시부터 확인한다. 업데이트 후에도 브라우저나 서버가 이전 CSS와 자바스크립트 파일을 불러오면 글자 크기, 메뉴와 화면 배치가 달라질 수 있다.
- 시크릿 창에서 사이트를 연다.
- 브라우저 캐시를 비운다.
- 캐시 플러그인의 전체 캐시를 삭제한다.
- 호스팅 서버 캐시가 있다면 함께 비운다.
- CDN을 사용한다면 해당 캐시도 갱신한다.
캐시를 비운 뒤 사이트 첫 화면, 개별 글, 관리자 페이지와 모바일 화면을 각각 확인한다.
시크릿 창에서는 정상인데 기존 브라우저에서만 깨져 보인다면 브라우저 캐시 문제일 가능성이 있다. 모든 환경에서 같은 오류가 나타나면 플러그인과 테마 점검으로 넘어간다.
2. 최근 업데이트한 플러그인을 비활성화한다
워드프레스 업데이트 오류가 특정 플러그인을 업데이트한 직후 시작됐다면 해당 플러그인을 먼저 비활성화한다.
관리자 화면이 열린다면 플러그인 → 설치한 플러그인으로 이동해 최근 업데이트한 항목을 하나씩 끈다.
- 업데이트한 플러그인 이름과 시간을 확인한다.
- 의심되는 플러그인 하나만 비활성화한다.
- 사이트 첫 화면과 오류가 난 기능을 다시 확인한다.
- 정상으로 돌아오면 플러그인을 다시 켜지 않는다.
관리자 페이지까지 열리지 않는다면 호스팅 파일 관리자나 FTP에서 다음 경로를 찾는다.
/wp-content/plugins/문제가 의심되는 플러그인 폴더 이름을 임시로 바꾼다.
sample-plugin-disabled어떤 플러그인인지 알 수 없다면 plugins 폴더 전체를 plugins-disabled로 바꿔 전체 플러그인을 일시 중지할 수 있다. 사이트가 열리면 폴더 이름을 되돌리고 플러그인을 하나씩 활성화한다.
먼저 확인해야 한다.
플러그인 폴더를 변경하기 전에 사이트 파일과 데이터베이스를 백업한다. 쇼핑몰, 예약, 회원과 보안 플러그인은 비활성화하는 동안 관련 기능이 멈출 수 있다.
3. 테마와 사용자 정의 코드를 확인한다
플러그인을 모두 꺼도 워드프레스 업데이트 오류가 계속되면 테마를 확인한다. 테마 업데이트 뒤 화면 구조가 무너지거나 functions.php 오류가 발생할 수 있다.
관리자 화면이 열린다면 외모 → 테마에서 워드프레스 기본 테마를 잠시 활성화한다. 기본 테마에서 사이트가 정상으로 보인다면 기존 테마나 자식 테마의 코드가 원인일 수 있다.
다음 항목을 확인한다.
- 테마와 현재 워드프레스 버전의 호환 여부
- 자식 테마에 직접 추가한 코드
functions.php에 넣은 사용자 정의 코드- 페이지 빌더와 테마의 지원 버전
- 테마 업데이트 전에 수정한 원본 파일
테마 원본 파일을 직접 수정했다면 업데이트 과정에서 변경 내용이 덮어써졌을 수 있다. 이전 백업과 현재 파일을 비교하되 원인을 모르는 상태에서 코드를 다시 붙여 넣지 않는 편이 안전하다.
주의: 사용 중인 테마 폴더를 바로 삭제하지 말아야 한다. 메뉴, 위젯과 디자인 설정을 복구하기 어려워질 수 있다. 먼저 기본 테마로 전환하거나 폴더 이름만 임시로 변경한다.
4. 백업 복원과 PHP 환경을 확인한다
플러그인과 테마를 확인해도 사이트가 복구되지 않으면 업데이트 전 백업을 확인한다. 워드프레스 공식 문서도 업데이트 전에 데이터베이스와 사이트 파일을 백업하도록 안내한다.
백업을 복원할 때는 다음 내용을 먼저 확인한다.
- 백업이 만들어진 날짜와 시간
- 사이트 파일과 데이터베이스가 모두 포함됐는지
- 백업 이후 작성된 글이나 주문이 있는지
- 복원 전에 현재 상태도 별도로 백업했는지
- 호스팅에서 복원 지점을 제공하는지
백업 이후 작성한 글, 댓글, 회원과 주문 정보가 있다면 과거 데이터베이스를 그대로 복원할 때 해당 정보가 사라질 수 있다. 운영 중인 쇼핑몰이나 회원 사이트는 직접 복원하기보다 호스팅 고객센터에 범위를 설명하는 편이 안전하다.
백업을 복원해도 같은 오류가 나타나거나 PHP 버전을 바꾼 직후 문제가 시작됐다면 호스팅 관리 화면에서 PHP 환경을 확인한다.
- 현재 PHP 버전을 테마와 플러그인이 지원하는지
- 업데이트 전후 PHP 버전이 달라졌는지
- PHP 메모리 제한에 도달했는지
- 서버 오류 로그에 같은 파일이 반복되는지
워드프레스 업데이트 방식과 사전 준비 사항은 워드프레스 공식 업데이트 안내에서 확인할 수 있다.
복구 후 다시 확인할 항목
사이트가 다시 열린 뒤 바로 모든 업데이트를 재실행하면 같은 문제가 반복될 수 있다.
- 오류를 일으킨 플러그인이나 테마를 기록한다.
- 사이트 첫 화면과 주요 글을 직접 확인한다.
- 관리자 페이지에서 글 저장을 시험한다.
- 모바일 화면과 시크릿 창에서 다시 확인한다.
- 호환 정보를 확인한 뒤 한 항목씩 업데이트한다.
- 복구된 상태의 전체 백업을 새로 만든다.
워드프레스 본체, 테마와 플러그인을 한 번에 업데이트하기보다 하나씩 진행하고 그때마다 사이트를 확인하면 원인을 찾기 쉬워진다.
워드프레스 업데이트 오류가 반복된다면 업데이트한 항목, 오류 발생 시간, PHP 버전과 서버 오류 메시지를 기록해 호스팅 고객센터에 전달한다.
자주 묻는 질문
업데이트 후 사이트가 깨지면 바로 백업을 복원해야 하나?
디자인만 깨졌다면 먼저 브라우저, 플러그인과 서버 캐시를 확인한다. 플러그인 하나를 비활성화해 해결되는 경우도 있다. 백업 복원은 기존 자료가 사라질 수 있으므로 원인을 확인한 뒤 결정한다.
업데이트를 취소하고 이전 버전으로 돌아갈 수 있나?
업데이트 대상과 백업 상태에 따라 가능하다. 이전 버전 파일만 임의로 덮어쓰면 데이터베이스와 코드 버전이 맞지 않을 수 있다. 공식 복구 기능이나 호스팅 백업을 먼저 확인한다.
자동 업데이트를 모두 꺼야 하나?
자동 업데이트를 모두 끄면 중요한 보안 업데이트가 늦어질 수 있다. 운영 환경과 백업 체계를 고려해 항목별로 판단해야 한다. 자동 업데이트 사용 여부보다 정상적인 백업과 복구 절차를 준비하는 것이 중요하다.
관리자 화면에 업데이트 중이라는 문구만 계속 나오면 어떻게 하나?
업데이트가 끝날 때까지 잠시 기다린 뒤 새로고침한다. 오랜 시간이 지나도 유지된다면 서버의 .maintenance 파일과 업데이트 상태를 확인해야 한다. 파일을 수정하기 전에는 호스팅 백업부터 만든다.
워드프레스 업데이트 오류 복구 방법 정리
- 브라우저, 캐시 플러그인과 서버 캐시를 먼저 비운다.
- 최근 업데이트한 플러그인을 하나씩 비활성화한다.
- 기본 테마로 전환해 테마 충돌 여부를 확인한다.
- 업데이트 전 백업과 PHP 환경을 확인한다.
- 복구 후에는 한 항목씩 업데이트하며 사이트를 점검한다.
워드프레스 업데이트 오류는 업데이트 파일을 바로 삭제하기보다 캐시, 플러그인, 테마와 백업 순서로 범위를 좁혀야 한다. 되돌리기 쉬운 항목부터 확인하고 백업 복원은 현재 자료에 미치는 영향을 살핀 뒤 진행한다.
업데이트 후 흰 화면만 나타난다면 워드프레스 흰 화면 오류 해결 글을 함께 확인한다. 사이트 주소를 변경한 뒤 접속이 막혔다면 워드프레스 주소 변경 후 접속 안 될 때 복구하는 3가지 방법을 확인한다.
지금 바로 할 일
업데이트 직전에 변경한 워드프레스, 플러그인과 테마 이름을 먼저 기록한다. 시크릿 창에서 사이트를 확인하고 캐시를 비운 뒤 최근 업데이트한 플러그인부터 하나씩 비활성화한다. 백업을 복원하거나 파일을 수정하기 전에는 현재 상태도 별도로 백업한다.
