워드프레스 업데이트 후 오류가 날 때 이전 버전으로 되돌리는 방법
워드프레스 업데이트 후 사이트 화면이 깨지거나 관리자 페이지 접속이 안 되고, 테마나 플러그인 충돌이 의심된다면 이전 버전으로 되돌리는 방법을 검토할 수 있습니다.
워드프레스 업데이트 후 사이트 화면이 깨지거나 관리자 페이지 접속이 안 되고, 테마나 플러그인 충돌이 의심된다면 이전 버전으로 되돌리는 방법을 검토할 수 있습니다. 다만 워드프레스 다운그레이드는 보안 위험과 데이터베이스 오류 가능성이 있기 때문에, 무조건 먼저 시도할 작업은 아닙니다.
이 글에서는 워드프레스 업데이트 후 오류가 발생했을 때 확인할 순서, 플러그인으로 이전 버전으로 되돌리는 방법, FTP로 수동 복구하는 방법, 다운그레이드 후 반드시 점검할 항목을 초보자 기준으로 정리합니다.
주의: 이 글은 설치형 워드프레스, 즉 WordPress.org 기반 사이트를 기준으로 설명합니다. WordPress.com에서 제공하는 호스팅형 서비스와는 관리 방식이 다를 수 있습니다.
목차
워드프레스 다운그레이드는 언제 필요한가
워드프레스는 보안, 성능, 기능 개선을 위해 정기적으로 업데이트됩니다. 일반적으로는 최신 버전을 유지하는 것이 좋습니다. 하지만 업데이트 직후 다음과 같은 문제가 생겼다면 일시적으로 이전 버전으로 되돌리는 방법을 검토할 수 있습니다.
- 워드프레스 업데이트 후 사이트가 흰 화면으로 보이는 경우
- 관리자 페이지인
wp-admin에 접속되지 않는 경우 - 특정 플러그인이 작동하지 않는 경우
- 테마 레이아웃이 갑자기 깨진 경우
- 결제, 예약, 문의 폼 같은 핵심 기능이 멈춘 경우
- PHP 버전 또는 호스팅 환경과 충돌이 발생한 경우
하지만 중요한 점이 있습니다. 문제가 발생했다고 해서 바로 워드프레스 코어 전체를 다운그레이드하는 것은 좋지 않습니다. 실제 원인은 워드프레스 자체보다 테마, 플러그인, 캐시, PHP 버전, 호스팅 설정에 있는 경우가 많습니다.
따라서 다운그레이드는 “최종 해결책”이 아니라, 사이트를 임시로 정상화하기 위한 복구 방법으로 접근하는 것이 안전합니다.
바로 다운그레이드하기 전에 먼저 확인할 것
워드프레스 업데이트 후 오류가 발생하면 먼저 원인을 좁혀야 합니다. 무작정 이전 버전으로 되돌리면 문제 원인을 놓칠 수 있고, 나중에 다시 업데이트할 때 같은 오류가 반복될 수 있습니다.
1. 최근에 업데이트한 항목 확인
먼저 어떤 항목을 업데이트했는지 확인합니다.
- 워드프레스 코어 업데이트
- 테마 업데이트
- 플러그인 업데이트
- PHP 버전 변경
- 호스팅 서버 설정 변경
관리자 페이지에 접속할 수 있다면 알림판 > 업데이트 또는 플러그인 목록에서 최근 업데이트 항목을 확인합니다. 관리자 페이지에 접속할 수 없다면 호스팅 관리자 페이지, 백업 기록, 이메일 알림을 확인합니다.
2. 플러그인 충돌 여부 확인
워드프레스 오류의 가장 흔한 원인 중 하나는 플러그인 충돌입니다. 관리자 페이지에 접속할 수 있다면 모든 플러그인을 잠시 비활성화한 뒤 사이트가 정상으로 돌아오는지 확인합니다.
정상으로 돌아온다면 플러그인을 하나씩 다시 활성화하면서 어떤 플러그인이 문제를 일으키는지 확인합니다.
관리자 페이지에 접속할 수 없다면 FTP 또는 호스팅 파일 관리자에서 다음 폴더 이름을 임시로 바꿔 플러그인을 비활성화할 수 있습니다.
wp-content/plugins
예를 들어 plugins 폴더 이름을 plugins_old로 바꾸면 워드프레스가 플러그인을 불러오지 못하게 됩니다. 이후 사이트가 열리는지 확인합니다.
3. 테마 문제인지 확인
플러그인이 원인이 아니라면 테마 충돌을 의심할 수 있습니다. 특히 최신 워드프레스 버전과 오래된 테마가 맞지 않으면 레이아웃 오류나 PHP 오류가 발생할 수 있습니다.
관리자 페이지에 접속할 수 있다면 기본 테마로 잠시 변경해 봅니다. 예를 들어 Twenty 계열 기본 테마로 바꾼 뒤 문제가 사라지는지 확인합니다.
테마 변경 후 정상화된다면 워드프레스 코어 다운그레이드보다 테마 업데이트, 테마 롤백, 테마 개발자 문의가 우선입니다.
4. 캐시 삭제
캐시 플러그인, CDN, 브라우저 캐시 때문에 업데이트 후 화면이 깨져 보이는 경우도 있습니다. 이때는 다음 항목을 순서대로 삭제합니다.
- 워드프레스 캐시 플러그인 캐시
- CDN 캐시
- 브라우저 캐시
- 서버 캐시
캐시 삭제만으로 해결되는 문제라면 다운그레이드를 할 필요가 없습니다.
5. 백업 파일이 있는지 확인
다운그레이드 전에는 반드시 백업이 있어야 합니다. 백업은 단순히 글만 저장하는 것이 아니라 파일과 데이터베이스 전체를 포함해야 합니다.
확인할 백업 항목은 다음과 같습니다.
- 워드프레스 전체 파일
- 데이터베이스
wp-content폴더wp-config.php파일.htaccess파일- 업로드 이미지
- 테마와 플러그인 파일
백업이 없다면 다운그레이드 작업은 매우 위험합니다. 특히 데이터베이스 구조가 바뀐 상태에서 코어 버전만 되돌리면 관리자 페이지 오류, 글 저장 오류, 플러그인 오류가 이어질 수 있습니다.
플러그인·테마 문제라면 해당 항목만 되돌리는 것이 먼저
업데이트 후 오류가 발생했을 때 가장 안전한 접근은 문제가 된 플러그인이나 테마만 이전 버전으로 되돌리는 것입니다. 워드프레스 코어 전체를 내리는 것보다 범위가 작고, 복구 후 다시 점검하기도 쉽습니다.
예를 들어 보안 플러그인, 페이지 빌더, 캐시 플러그인, 쇼핑몰 플러그인을 업데이트한 직후 오류가 발생했다면 워드프레스 전체 다운그레이드보다 해당 플러그인 롤백을 먼저 검토합니다.
WordPress.org 플러그인·테마를 사용 중이라면 WP Rollback 같은 플러그인을 이용해 이전 버전으로 되돌릴 수 있습니다. 다만 이 경우에도 운영 중인 사이트에서 바로 적용하기보다 백업 후 진행해야 하며, 가능하다면 테스트 사이트에서 먼저 확인하는 것이 안전합니다.
사이트 오류는 단순한 기술 문제가 아니라 블로그 신뢰도와 광고 심사 환경에도 영향을 줄 수 있습니다. 특히 애드센스를 운영하거나 준비 중이라면 사이트가 정상적으로 열리는지, 메뉴와 주요 글이 깨지지 않는지 함께 점검하는 것이 좋습니다.
관리자 페이지 접속이 가능할 때: WP Downgrade 사용법
관리자 페이지에 정상적으로 접속할 수 있다면 플러그인을 이용한 다운그레이드가 비교적 간단합니다. 대표적으로 WP Downgrade | Specific Core Version 플러그인을 사용할 수 있습니다.
단, 이 방법은 워드프레스 코어 버전을 되돌리는 작업입니다. 플러그인이나 테마 하나만 문제가 된 상황이라면 앞에서 설명한 플러그인·테마 롤백을 먼저 검토하는 것이 좋습니다.
1. 백업부터 진행
먼저 사이트 전체를 백업합니다. 최소한 다음 항목은 반드시 백업해야 합니다.
- 데이터베이스
- 워드프레스 전체 파일
wp-content폴더wp-config.php.htaccess
호스팅 업체에서 자동 백업 기능을 제공한다면 복원 가능한 백업인지 확인합니다. 백업 파일이 있다고 해도 실제 복원이 불가능하면 의미가 없습니다.
2. WP Downgrade 플러그인 설치
워드프레스 관리자 페이지에서 다음 경로로 이동합니다.
플러그인 > 새로 추가
검색창에 다음 이름을 입력합니다.
WP Downgrade
검색 결과에서 WP Downgrade | Specific Core Version 플러그인을 설치하고 활성화합니다.
3. 목표 버전 입력
플러그인 활성화 후 다음 경로로 이동합니다.
설정 > WP Downgrade
WordPress Target Version 입력칸에 되돌리고 싶은 버전을 정확히 입력합니다.
예를 들어 이전에 사용하던 안정 버전이 6.9.4였다면 해당 버전을 입력합니다. 버전 숫자를 잘못 입력하면 원하는 파일을 찾지 못하거나 잘못된 버전으로 진행될 수 있으므로 반드시 확인해야 합니다.
4. 변경사항 저장 후 다운그레이드 실행
목표 버전을 입력한 뒤 변경사항 저장을 클릭합니다.
이후 표시되는 Up-/Downgrade Core 버튼을 클릭하면 워드프레스 업데이트 화면으로 이동합니다. 화면에 표시되는 버전이 내가 입력한 목표 버전과 일치하는지 확인한 뒤 지금 다시 설치를 클릭합니다.
5. 완료 후 사이트 확인
다운그레이드가 끝나면 다음 항목을 확인합니다.
- 사이트 첫 화면이 정상적으로 열리는가
- 관리자 페이지에 접속되는가
- 글 작성 화면이 정상적으로 열리는가
- 플러그인 목록이 정상적으로 보이는가
- 테마 레이아웃이 깨지지 않는가
- 문의 폼, 결제, 로그인 기능이 작동하는가
문제가 해결되었다면 바로 끝내지 말고, 어떤 플러그인이나 테마가 최신 워드프레스와 충돌했는지 원인을 기록해 두는 것이 좋습니다.
복구 후에는 주요 글 URL이 정상적으로 열리는지 확인하고, 필요한 경우 구글 서치콘솔 URL 검사로 Google이 페이지에 접근할 수 있는지 점검하는 것이 좋습니다.
관리자 페이지 접속이 안 될 때: FTP 수동 다운그레이드 방법
관리자 페이지에 접속할 수 없다면 플러그인을 사용할 수 없습니다. 이때는 FTP 또는 호스팅 파일 관리자를 이용해 워드프레스 코어 파일을 수동으로 교체해야 합니다.
이 방법은 초보자에게 어렵고 위험할 수 있습니다. 가능하면 호스팅 업체의 백업 복원 기능을 먼저 확인하고, 직접 작업하기 어렵다면 전문가에게 의뢰하는 것이 안전합니다.
1. 이전 버전 워드프레스 파일 다운로드
워드프레스 공식 릴리스 페이지에서 되돌릴 버전의 압축 파일을 다운로드합니다.
공식 릴리스 페이지에는 과거 워드프레스 버전이 정리되어 있습니다. 다만 오래된 버전은 보안상 안전하지 않을 수 있으므로, 반드시 임시 복구 목적으로만 사용해야 합니다.
다운로드한 압축 파일을 내 컴퓨터에서 풉니다.
2. FTP 또는 파일 관리자 접속
FileZilla 같은 FTP 프로그램이나 호스팅에서 제공하는 파일 관리자로 서버에 접속합니다.
워드프레스가 설치된 폴더로 이동합니다. 보통 다음과 같은 이름을 사용합니다.
public_htmlwwwhtdocs- 도메인 이름으로 된 폴더
사이트마다 구조가 다를 수 있으므로, 기존에 wp-admin, wp-content, wp-includes 폴더가 있는 위치를 기준으로 확인합니다.
3. 기존 코어 파일 삭제
서버에서 다음 폴더를 삭제합니다.
wp-adminwp-includes
그 다음 워드프레스 루트에 있는 코어 파일도 교체 대상입니다. 다만 아래 항목은 절대 삭제하면 안 됩니다.
wp-contentwp-config.php.htaccessrobots.txt- 직접 추가한 인증 파일 또는 호스팅 설정 파일
특히 wp-content 폴더에는 이미지, 테마, 플러그인, 업로드 파일이 들어 있습니다. 이 폴더를 삭제하면 사이트 콘텐츠와 디자인이 크게 손상될 수 있습니다.
wp-config.php 파일에는 데이터베이스 접속 정보와 사이트 설정이 들어 있으므로 삭제하거나 덮어쓰면 사이트가 데이터베이스에 연결되지 않을 수 있습니다.
4. 이전 버전 파일 업로드
내 컴퓨터에서 압축을 푼 워드프레스 폴더를 엽니다.
그 안에서 wp-content 폴더는 제외합니다. 나머지 파일과 폴더를 서버의 워드프레스 설치 폴더에 업로드합니다.
업로드할 항목은 대체로 다음과 같습니다.
wp-adminwp-includes- 루트의 각종 PHP 파일
- 루트의 기본 워드프레스 파일
업로드 중 “덮어쓰기” 메시지가 나오면 코어 파일에 한해 덮어씁니다. 단, 앞에서 말한 wp-config.php, wp-content, .htaccess는 건드리지 않아야 합니다.
5. 데이터베이스 업데이트 확인
업로드가 끝나면 브라우저에서 다음 주소로 접속합니다.
내도메인.com/wp-admin
워드프레스가 데이터베이스 업데이트를 요청할 수 있습니다. 이때 안내에 따라 업데이트를 진행합니다.
다만 데이터베이스 업데이트는 되돌리기 어려울 수 있으므로, 이 단계 전에도 백업이 반드시 필요합니다.
6. 사이트 동작 확인
수동 다운그레이드 후에는 다음 항목을 확인합니다.
- 홈 화면 정상 표시
- 글 상세 페이지 정상 표시
- 관리자 로그인 가능 여부
- 플러그인 페이지 접근 가능 여부
- 테마 설정 유지 여부
- 미디어 파일 정상 표시
- 문의 폼, 결제, 회원가입, 댓글 기능 정상 작동 여부
사이트 복구 후에도 글이 검색 결과에 바로 보이지 않을 수 있습니다. 이때는 색인 문제, robots.txt, noindex, 사이트맵, 내부링크 상태를 함께 점검해야 합니다.
다운그레이드 후 반드시 해야 할 일
워드프레스 다운그레이드는 완료보다 사후 점검이 더 중요합니다. 이전 버전으로 되돌린 상태를 오래 유지하면 보안 위험이 커질 수 있습니다.
1. 플러그인을 하나씩 다시 확인
오류 원인을 찾기 위해 플러그인을 하나씩 비활성화하거나 활성화하면서 확인합니다. 한꺼번에 여러 플러그인을 켜면 어떤 플러그인이 문제인지 알기 어렵습니다.
특히 다음 유형의 플러그인은 충돌 가능성이 높습니다.
- 캐시 플러그인
- 보안 플러그인
- 페이지 빌더
- 쇼핑몰 플러그인
- 회원가입 플러그인
- SEO 플러그인
- 이미지 최적화 플러그인
2. 테마 업데이트 여부 확인
테마가 오래된 경우 최신 워드프레스와 충돌할 수 있습니다. 사용 중인 테마가 최근에도 유지보수되고 있는지 확인합니다.
테마 개발이 중단되었거나 PHP 최신 버전과 맞지 않는다면 장기적으로는 테마 변경을 검토하는 것이 좋습니다.
3. PHP 버전 확인
워드프레스 오류는 PHP 버전과도 관련이 있습니다. 호스팅에서 PHP 버전을 갑자기 올렸거나, 반대로 너무 낮은 PHP 버전을 유지하고 있다면 문제가 생길 수 있습니다.
호스팅 관리자 페이지에서 PHP 버전을 확인하고, 사용 중인 워드프레스·테마·플러그인이 해당 PHP 버전을 지원하는지 확인합니다.
4. 최신 안정 버전으로 다시 업데이트할 계획 세우기
다운그레이드는 임시 조치입니다. 사이트가 정상화되었다면 다음 순서로 다시 업데이트 계획을 세워야 합니다.
- 전체 백업 생성
- 테스트 사이트 또는 스테이징 환경 준비
- 테마 업데이트
- 플러그인 하나씩 업데이트
- 워드프레스 코어 업데이트
- 주요 기능 테스트
- 운영 사이트에 반영
최신 버전으로 돌아갈 계획 없이 오래된 버전을 계속 사용하면 보안 취약점에 노출될 수 있습니다.
5. 복구 후 검색 노출 상태 점검
사이트가 며칠 동안 오류 상태였거나, 일부 페이지가 500 오류 또는 흰 화면으로 보였다면 검색엔진이 해당 페이지를 정상적으로 가져오지 못했을 수 있습니다.
이때는 다음 항목을 확인합니다.
- 주요 글 URL이 정상적으로 열리는가
- 사이트맵이 정상적으로 접근되는가
- robots.txt에서 차단하지 않았는가
- 구글 서치콘솔에서 색인 상태가 정상인가
- 내부링크가 깨지지 않았는가
워드프레스 글이지만, 검색엔진이 사이트 구조를 발견하고 색인하는 원리는 블로그스팟 운영자에게도 중요합니다. 사이트 복구 후에는 검색엔진 접근 상태를 함께 점검하는 습관이 필요합니다.
워드프레스 다운그레이드할 때 자주 하는 실수
wp-content 폴더를 삭제하는 실수
wp-content 폴더에는 사이트의 핵심 콘텐츠 파일이 들어 있습니다. 업로드 이미지, 테마, 플러그인 파일이 모두 이 폴더에 포함됩니다.
수동 다운그레이드 중 이 폴더를 삭제하면 사이트 디자인이 사라지거나 이미지가 보이지 않을 수 있습니다.
wp-config.php를 덮어쓰는 실수
wp-config.php 파일은 워드프레스 설치 폴더에서 매우 중요한 파일입니다. 데이터베이스 이름, 사용자명, 비밀번호, 보안 키 등이 들어 있습니다.
이 파일을 삭제하거나 잘못 덮어쓰면 워드프레스가 데이터베이스에 연결하지 못해 사이트가 열리지 않을 수 있습니다.
너무 오래된 버전으로 되돌리는 실수
오류가 발생했다고 해서 몇 년 전 버전으로 되돌리는 것은 위험합니다. 가능하면 바로 직전 안정 버전 또는 호환이 확인된 버전으로만 되돌리는 것이 좋습니다.
오래된 버전은 보안 업데이트가 부족할 수 있고, 최신 플러그인·테마와 오히려 더 크게 충돌할 수 있습니다.
백업 없이 작업하는 실수
백업 없이 다운그레이드를 진행하면 문제가 생겼을 때 원래 상태로 되돌리기 어렵습니다. 특히 데이터베이스가 손상되면 단순히 파일만 다시 올려서는 복구가 어려울 수 있습니다.
원인 기록 없이 끝내는 실수
다운그레이드 후 사이트가 정상으로 돌아오면 안심하고 작업을 끝내는 경우가 많습니다. 하지만 원인을 기록하지 않으면 다음 업데이트 때 같은 문제가 반복됩니다.
다음 항목을 간단히 메모해 두는 것이 좋습니다.
- 문제가 발생한 날짜
- 업데이트한 워드프레스 버전
- 충돌한 플러그인 또는 테마
- 복구한 버전
- 해결 방법
- 다시 업데이트하기 전 확인할 항목
워드프레스 업데이트 후 오류 해결 순서 요약
워드프레스 업데이트 후 오류가 발생했다면 아래 순서대로 진행하는 것이 안전합니다.
- 사이트 전체 백업 확인
- 최근 업데이트 항목 확인
- 캐시 삭제
- 플러그인 전체 비활성화 테스트
- 테마를 기본 테마로 변경 테스트
- 문제 플러그인 또는 테마만 롤백
- 그래도 해결되지 않으면 워드프레스 코어 다운그레이드 검토
- 관리자 페이지 접속 가능 시 WP Downgrade 사용
- 관리자 페이지 접속 불가 시 FTP 수동 복구
- 복구 후 최신 안정 버전으로 돌아갈 계획 수립
핵심은 “바로 다운그레이드”가 아니라 원인을 좁힌 뒤 최소 범위로 복구하는 것입니다.
FAQ
Q1. 워드프레스 다운그레이드는 안전한가요?
항상 안전하다고 볼 수는 없습니다. 워드프레스 코어 버전을 되돌리면 보안 업데이트가 빠질 수 있고, 데이터베이스 구조 차이로 오류가 생길 수 있습니다. 따라서 백업 후 임시 복구 목적으로만 사용하는 것이 좋습니다.
Q2. 백업 없이 다운그레이드해도 되나요?
권장하지 않습니다. 특히 수동 FTP 다운그레이드는 파일과 데이터베이스가 함께 영향을 받을 수 있기 때문에, 백업 없이 진행하면 복구가 어려워질 수 있습니다.
Q3. 플러그인만 이전 버전으로 되돌릴 수 있나요?
가능합니다. WordPress.org에 등록된 플러그인이나 테마라면 WP Rollback 같은 도구를 사용할 수 있습니다. 다만 유료 플러그인이나 유료 테마는 공식 배포처에서 이전 버전 파일을 제공하는지 확인해야 합니다.
Q4. 관리자 페이지에 접속이 안 되면 어떻게 해야 하나요?
FTP 또는 호스팅 파일 관리자로 접속해 플러그인 폴더 이름을 임시 변경해 보세요. 그래도 해결되지 않으면 테마 폴더, 코어 파일, PHP 오류 로그를 확인해야 합니다. 백업이 있다면 호스팅 복원 기능을 이용하는 것이 가장 안전할 수 있습니다.
Q5. wp-content 폴더는 왜 삭제하면 안 되나요?
wp-content 폴더에는 이미지, 테마, 플러그인, 업로드 파일이 들어 있습니다. 이 폴더를 삭제하면 사이트 디자인과 콘텐츠 파일이 손상될 수 있습니다.
Q6. 다운그레이드 후 자동 업데이트는 꺼야 하나요?
일시적으로는 자동 업데이트 설정을 점검할 수 있습니다. 하지만 장기적으로 자동 업데이트를 모두 꺼 두는 것은 보안상 좋지 않을 수 있습니다. 문제 원인을 해결한 뒤 최신 안정 버전으로 다시 업데이트하는 계획을 세우는 것이 좋습니다.
Q7. 워드프레스 이전 버전은 어디에서 받을 수 있나요?
워드프레스 공식 릴리스 페이지에서 과거 버전을 확인할 수 있습니다. 다만 오래된 버전은 보안 위험이 있으므로 필요한 경우에만 신중하게 사용해야 합니다.
결론
워드프레스 업데이트 후 오류가 발생하면 당황해서 바로 이전 버전으로 되돌리고 싶어질 수 있습니다. 하지만 가장 안전한 순서는 백업 확인 → 원인 확인 → 플러그인·테마 롤백 → 코어 다운그레이드 검토 → FTP 수동 복구 → 최신 안정 버전 복귀 계획입니다.
특히 관리자 페이지에 접속할 수 있다면 WP Downgrade 같은 플러그인을 이용해 비교적 쉽게 이전 버전으로 되돌릴 수 있습니다. 반대로 관리자 페이지에 접속할 수 없다면 FTP로 수동 복구해야 하지만, 이때는 wp-content, wp-config.php, .htaccess 같은 핵심 파일을 절대 삭제하지 않도록 주의해야 합니다.
다운그레이드는 최종 목적이 아닙니다. 사이트를 임시로 정상화한 뒤, 충돌 원인을 찾아 최신 안정 버전으로 다시 돌아가는 것이 장기적으로 가장 안전한 운영 방법입니다.
함께 보면 좋은 ITNAI 블로그 운영 글
출처
- WordPress.org Release Archive: 워드프레스 공식 릴리스 목록과 최신 유지보수 버전 정보 기준
- WordPress Developer Resources - Upgrading WordPress: 워드프레스 업그레이드 전 백업, 수동 업그레이드, 파일 교체 주의사항 기준
- WordPress Developer Resources - Editing wp-config.php:
wp-config.php파일의 역할과 관리 주의사항 기준 - WordPress.org Plugin Directory - Downgrade: WP Downgrade 플러그인 정보 기준
- WordPress.org Plugin Directory - WP Rollback: 플러그인·테마 롤백 기능 설명 기준
- Making WordPress Security: 오래된 워드프레스 버전의 보안 업데이트 관련 공식 안내 기준
