워드프레스 업데이트 후 오류: 복구 전 점검 순서
워드프레스 업데이트 후 오류 해결 방법을 정리했습니다. 화면 깨짐과 치명적 오류가 생겼을 때 캐시 확인부터 복구 모드, 플러그인 충돌 점검, 백업 복원까지 안전한 순서로 확인하세요.
워드프레스 업데이트 뒤 오류가 나면 먼저 현재 상태를 백업하세요. 오류가 시작된 시각과 마지막 업데이트를 적은 뒤 증상에 맞는 항목을 하나씩 확인합니다.
- 현재 상태 백업하고 마지막 변경 기록하기
- 캐시와 복구 모드 확인하기
- 플러그인·테마 충돌 확인하기
- 로그를 보고 복원 범위 결정하기
참고: 워드프레스 복구 모드, 워드프레스 백업
이 글은 업데이트 직후 레이아웃이 무너지거나, 흰 화면·치명적인 오류·500 오류가 나타난 상황을 기준으로 설명합니다. 관리자 페이지에 들어갈 수 없는 경우도 함께 다룹니다.
더 바꾸기 전에 무엇을 기록하나요?
- 현재 상태를 보존합니다. 복원 가능성을 판단하려면 파일과 데이터베이스의 백업 시각·범위를 함께 확인합니다.
- 오류 화면을 캡처합니다. 오류 문구가 보인다면 생략하지 말고 함께 저장하세요.
- 마지막 변경을 적습니다. 업데이트한 플러그인·테마·워드프레스 코어와 대략적인 시각을 기록합니다.
- 방문자 화면과 관리자 화면을 각각 확인합니다. 둘 중 한쪽만 고장 났는지에 따라 점검 순서가 달라집니다.
주의: 정상 작동하던 백업으로 복원하면 그 백업 이후에 들어온 주문, 문의, 회원 정보, 글 수정 내용이 사라질 수 있습니다. 쇼핑몰이나 예약·상담 사이트라면 복원 전에 최신 데이터도 별도로 보관해야 합니다.
증상에 따라 먼저 확인할 부분
| 증상 | 확인할 단서 | 먼저 할 일 |
|---|---|---|
| 글자·색상·배치만 깨짐 | 브라우저·캐시 플러그인·CDN 캐시, CSS 생성 오류 | 다른 브라우저에서 재현 여부 확인 |
| 치명적인 오류 또는 흰 화면 | PHP 오류, 플러그인·테마 충돌 | 복구 모드 메일과 오류 로그 확인 |
| 500 오류 | PHP 오류·서버 설정 등 | 호스팅 오류 로그와 최근 변경 확인 |
| 유지보수 화면이 계속 나옴 | 업데이트 중단 여부 | 백업과 호스팅 상태 확인 |
| 관리자 화면만 열리지 않음 | 관리자 기능·로그인·PHP 오류 | 오류 문구와 복구 모드 메일 확인 |
캐시를 지우면 화면이 돌아오나요?
업데이트는 끝났지만 브라우저나 서버가 이전 CSS·자바스크립트 파일을 보여주면 화면만 깨져 보일 수 있습니다. 다음 순서로 확인하세요.
- 시크릿 창이나 다른 브라우저에서 사이트를 엽니다.
- Windows는 Ctrl + F5, Mac은 Command + Shift + R로 강력 새로고침합니다.
- 사용 중인 캐시 플러그인의 캐시를 비웁니다.
- 호스팅 서버 캐시와 CDN을 사용한다면 해당 캐시도 삭제합니다.
- 휴대전화의 모바일 데이터처럼 다른 네트워크에서도 확인합니다.
캐시를 지운 뒤 정상으로 보이면 플러그인을 되돌릴 필요가 없습니다. 반대로 치명적인 오류나 500 오류가 계속된다면 아래 충돌 점검으로 넘어가세요.
레이아웃만 무너진 경우에는 워드프레스 레이아웃이 깨졌을 때 점검 방법도 함께 확인해 보세요.
복구 모드 이메일이 왔나요?
워드프레스는 사이트를 멈추게 한 치명적인 PHP 오류를 감지하면 관리자 이메일로 복구 모드 링크를 보낼 수 있습니다. 메일 제목에 사이트의 기술적 문제나 복구 모드와 관련된 안내가 표시됩니다.
- 관리자 이메일의 받은편지함과 스팸함을 확인합니다.
- 메일에 적힌 오류 플러그인 또는 테마 이름을 기록합니다.
- 복구 모드 링크로 접속합니다.
- 문제를 일으킨 항목을 비활성화한 뒤 방문자 화면을 다시 확인합니다.
복구 모드로 로그인한 동안에만 문제가 된 플러그인이나 테마가 잠시 멈출 수 있습니다. 방문자에게 보이는 오류가 자동으로 모두 해결된다는 뜻은 아니므로, 원인을 확인한 뒤 해당 항목을 비활성화하거나 수정해야 합니다. 워드프레스 복구 모드
관리자 화면에 들어갈 수 있다면
방금 업데이트한 플러그인이 하나뿐이라면, 먼저 운영 사이트의 결제·예약·문의·보안 기능에 미칠 영향을 확인하세요. 백업과 원상복구 방법을 준비하고 가능하면 스테이징에서 시험한 뒤 그 플러그인을 비활성화해 오류가 사라지는지 봅니다.
여러 항목을 한꺼번에 업데이트했다면 어느 쪽이 문제인지 가려내는 데 시간이 걸립니다. 운영 중인 사이트에서 플러그인을 무작정 끄면 결제나 예약 기능이 멈출 수 있습니다. 이 단계부터는 저희에게 맡겨 주셔도 됩니다.
플러그인에서 원인이 발견되지 않으면 백업 또는 스테이징 사이트에서 기본 테마로 잠시 전환해 테마 충돌을 확인합니다. 운영 중인 사이트에서 준비 없이 테마를 바꾸면 메뉴와 위젯 배치가 달라질 수 있습니다.
관리자 화면에도 들어갈 수 없다면
관리자 화면에 들어갈 수 없으면 서버 파일을 직접 다뤄야 합니다. 이때 잘못 건드리면 사이트가 더 망가질 수 있습니다. (지움)
어떤 플러그인이 문제인지 모른다면 운영 사이트에서 전체를 끄기 전에 영향받는 기능을 확인하세요. 파일 관리자나 FTP로 폴더를 바꾸는 진단은 백업과 원상복구 방법을 갖춘 담당자가 진행하고, 이후 하나씩 재현 여부를 점검합니다.
서버 파일을 다루기 어렵다면 먼저 호스팅 업체에 최근 PHP 오류 로그와 백업 복원 가능 시점을 문의하세요. 파일을 삭제할 필요는 없습니다.
이전 버전이나 백업으로 되돌리기 전에
복원은 원인과 백업 시점에 따라 범위를 정해야 합니다. 특정 플러그인 파일만 되돌려 해결할 수도 있지만, 코드와 데이터베이스 구조가 함께 바뀐 경우에는 호환성을 확인해야 합니다. 데이터베이스까지 과거 시점으로 되돌리면 이후 주문·문의·회원 정보가 사라질 수 있으므로 최신 데이터를 보존하고 복구 계획을 세우세요. 워드프레스 백업 안내
특정 플러그인만 이전 버전으로 돌린다면 공식 저장소나 제작사에서 받은 정식 파일만 써야 합니다. 모든 플러그인이 이전 버전을 제공하는 것은 아니며, 출처를 알 수 없는 다운로드 사이트는 사용하지 마세요.
이전 버전으로 돌리는 것은 임시 조치입니다. 이전 버전에는 보안 취약점이 남아 있을 수 있고, 업데이트 과정에서 바뀐 데이터베이스가 자동으로 원상 복구되지 않을 수도 있습니다. 특히 워드프레스 코어의 다운그레이드는 보안과 데이터베이스 호환 문제 때문에 권장하지 않습니다.
화면 모양만 깨졌다면 CSS를 확인해 주세요
페이지 빌더나 최적화 플러그인을 사용하는 사이트는 업데이트 후 생성된 CSS 파일이 오래된 캐시와 맞지 않을 수 있습니다. 모든 캐시를 비운 뒤, 사용 중인 빌더가 제공하는 CSS 재생성 또는 파일 재생성 기능을 실행하고 다시 확인하세요. 기능 이름과 위치는 빌더 버전에 따라 다릅니다.
직접 추가한 CSS나 자식 테마가 있다면 업데이트된 HTML 구조와 선택자가 맞는지도 확인해야 합니다. 원본 테마 파일을 직접 수정한 경우에는 업데이트 때 변경 내용이 덮어쓰일 수 있으므로, 이후에는 자식 테마나 별도의 사용자 정의 영역을 사용하는 편이 안전합니다.
원인이 안 보이면 어디를 확인하나요?
- 도구 → 사이트 상태: PHP 버전, REST API, 자동 업데이트 등 사이트 상태를 확인합니다.
- 호스팅 PHP 오류 로그: 오류가 발생한 파일 경로와 플러그인·테마 이름을 찾습니다.
- 복구 모드 이메일: 치명적인 오류를 일으킨 파일 정보가 포함될 수 있습니다.
- 디버그 로그: 백업 또는 스테이징 사이트에서 필요한 시간 동안만 활성화합니다.
디버그 메시지를 방문자 화면에 그대로 표시하면 서버 경로나 민감한 정보가 노출될 수 있습니다. 운영 사이트에서는 화면 표시를 끄고 로그 파일로만 기록하며, 점검이 끝나면 디버그 기능도 다시 꺼야 합니다. 워드프레스 디버깅 안내
500 오류가 계속된다면 HTTP 500 오류 해결 가이드에서 서버 설정과 PHP 오류 점검 순서를 확인하세요. 관리자 로그인 자체가 되지 않는다면 워드프레스 관리자 로그인 오류 해결 방법도 도움이 됩니다.
직접 복구하기 어렵다면
원인을 모른 채 파일을 삭제하거나 덮어쓰지 마세요. 저희에게 맡겨 주시면 오류 로그와 백업이 남아 있는지부터 보고, 어디까지 되돌려야 하는지 말씀드립니다.