WordPress 업데이트 실패 오류: 해결 방법

게시 됨: 2021-06-05

사이트를 업데이트하는 동안 "WordPress 업데이트 실패" 오류 메시지가 나타납니까? WordPress에서 업데이트 및 게시 실패는 매우 성가실 수 있습니다. 그렇기 때문에 가능한 이유와 WordPress 업데이트 실패 오류를 수정하는 방법을 해결하는 방법을 보여주는 이 가이드를 마련했습니다.

WordPress에는 업데이트 프로세스를 더 쉽게 만드는 자동 업데이트 기능이 있습니다. 자동 업데이트를 활성화하면 사이트에서 백그라운드에서 모든 새 릴리스(예: 5.7.1 ~ 5.7.2)를 자동으로 설치합니다. 주요 업데이트의 경우 WordPress를 업데이트하라는 알림을 받게 되며 몇 번의 클릭으로 사이트를 최신 버전으로 업데이트할 수 있습니다.

아시다시피 사이트를 최신 상태로 유지하는 것은 정말 중요합니다. 각각의 새 릴리스에는 중요한 버그 수정, 최적화 및 새로운 기능이 포함되어 있습니다. 그러나 때때로 업데이트가 실패하고 WordPress 업데이트 실패 오류가 표시됩니다. 이 경우 현재 버전에 고정되어 최신 기능을 놓치게 됩니다.

이제 WordPress 업데이트 실패 오류를 수정하는 방법을 살펴보겠습니다.

WordPress 업데이트 실패 오류의 원인 식별

업데이트 실패 문제를 해결하려면 먼저 실패의 근본 원인을 식별해야 합니다. 실패 이유에 따라 다른 수정 사항을 적용할 수 있습니다.

WordPress 업데이트 실패 오류 메시지를 보면 가능한 원인이 나와 있습니다. 예를 들어 현재 WordPress 버전이 5.7.1이고 5.7.2로 업데이트하려고 하지만 업데이트에 실패했다고 가정해 보겠습니다. 다음과 같은 오류 메시지가 표시됩니다.

 http://wordpress.org/wordpress-5.7.2.zip에서 업데이트 다운로드 중...
업데이트 압축을 푸는 중...
압축을 푼 파일 확인 중...
최신 버전 설치 중...
파일을 복사할 수 없습니다.: /httpdocs/wordpress/wp-admin/js/list table.dev.js
설치 실패

5행을 확인하면 워드프레스가 언급된 파일을 복사할 수 없다고 나와 있습니다. 마찬가지로 업데이트 실패의 가능한 원인이 포함된 오류 메시지가 나타날 수 있습니다.

WordPress 업데이트 실패 오류를 수정하는 방법

여러 가지 이유로 WordPress 업데이트 실패 오류가 발생할 수 있습니다. 이 섹션에서는 다양한 솔루션을 살펴보겠습니다.

  1. .maintenance 파일 삭제
  2. 파일 권한
  3. 안전 모드 끄기
  4. wp-config 파일에 FTP 세부 정보 추가
  5. 수동으로 WordPress 업데이트

WordPress 업데이트 실패 문제를 해결하는 데 도움이 될 수 있는 각 솔루션을 살펴보겠습니다.

1. .maintenance 파일 삭제

일반적으로 WordPress 업데이트에 실패한 후에는 사이트가 잠깁니다. 즉, 더 이상 WP 관리 대시보드 또는 웹사이트의 모든 페이지에 액세스할 수 없습니다. 귀하의 사이트를 방문하는 최종 사용자는 "예정된 유지 관리에 잠시 사용할 수 없습니다. 잠시 후에 다시 확인하십시오.”

이것은 업데이트 프로세스 중에 WordPress가 사이트를 유지 관리 모드로 전환하기 때문에 발생합니다. 이제 업데이트가 실패하여 유지 관리 모드로 유지됩니다. 이 정보는 WordPress 디렉토리의 .maintenance 파일(파일 이름이 "점"으로 시작함을 기억하십시오)에 저장됩니다.

이 문제를 해결하려면 사이트의 루트 디렉터리로 이동하여 .maintenance 파일을 삭제하기만 하면 됩니다. 이를 위해서는 서버의 제어판을 통해 또는 FileZilla와 같은 FTP 클라이언트를 사용하여 얻을 수 있는 WordPress 사이트의 루트 디렉토리에 대한 FTP 액세스가 필요합니다.

WordPress 업데이트 실패 오류: 해결 방법 - FTP

.maintenance 파일을 제거하면 웹사이트에 다시 액세스할 수 있습니다. 그런 다음 로그인하여 업데이트 실패의 원인이 된 오류 메시지를 확인할 수 있습니다.

2. 파일 권한

WordPress 업데이트 실패 오류가 발생할 수 있는 또 다른 이유는 서버가 /upgrade/ 디렉토리에서 업데이트하는 동안 필요한 임시 파일을 생성할 수 없는 경우입니다. 임시 파일을 생성하려면 서버에 해당 디렉토리에 대한 쓰기 권한이 필요합니다.

이 문제를 해결하려면 WordPress 루트 디렉터리로 다시 라우팅해야 합니다. 루트 디렉토리에서 /upgrade/ 디렉토리를 찾아 쓰기 권한을 부여하십시오. 필요한 755(CHMOD) 권한을 부여하거나 짧은 시간 동안 전체 777 권한을 사용할 수 있습니다.

디렉토리에 적절한 파일 권한을 부여하면 사이트 업데이트를 다시 시도할 수 있습니다. 자동 업데이트가 계속 실패하면 /upgrade/ 디렉터리를 삭제하고 다시 만든 다음 필요한 권한을 부여합니다. 그런 다음 업데이트를 다시 시작하면 작동합니다.

/upgrade/ 디렉토리에 전체 777 권한을 부여하는 경우 업데이트 후 엄격한 755 권한으로 다시 변경해야 합니다. 서버에 대한 전체 777 권한을 허용하는 것은 권장되지 않으므로 가능한 한 짧게 유지해야 합니다.

3. 안전 모드 끄기

안전 모드를 끄면 WordPress 업데이트 실패 문제에 도움이 될 수 있습니다. 그러나 안전 모드는 PHP 버전 5.3.0부터 더 이상 사용되지 않으며 PHP 매뉴얼에 따라 버전 5.4에서 제거되었습니다. 설명서에는 다음과 같이 나와 있습니다.

이 기능은 PHP 5.3.0에서 더 이상 사용되지 않으며 PHP 5.4.0에서 제거되었습니다.

이전 버전의 PHP로 작업하는 경우 업데이트를 방해하는 일부 문제를 해결할 수 있으므로 안전 모드를 끄는 것이 좋습니다. 서버의 제어판을 통해 안전 모드를 끄거나 FTP 클라이언트를 통해 php.ini 파일을 편집할 수 있습니다. 편집기에서 php.ini 파일을 열고 행을 변경하기만 하면 됩니다.

 안전 모드 = 켜짐

에게

 안전 모드=꺼짐

그런 다음 Apache를 다시 시작하고 사이트에 로그인합니다. 문제 없이 WordPress를 업데이트할 수 있어야 합니다.

4. wp-config 파일에 FTP 세부 정보 추가

FTP 자격 증명이 업데이트되지 않아 WordPress에서 업데이트가 실패하는 경우가 있습니다. 이는 사이트가 최근에 이동되었거나 비밀번호, 권한 등과 같은 항목을 업데이트했기 때문에 발생할 수 있습니다.

이러한 경우 wp-config 파일을 편집하여 업데이트된 자격 증명을 WordPress에 수동으로 제공할 수 있습니다.

먼저 올바른 FTP 자격 증명을 가지고 있는지 확인하십시오. 그런 다음 cPanel 또는 FTP 클라이언트를 통해 wp-config 파일로 이동합니다.

메모장과 같은 텍스트 편집기로 wp-config 파일을 열고 "/ * 그게 다야, 편집을 중지하십시오! 행복한 블로깅. */” .

 정의('FS_METHOD', 'ftpext');
정의('FTP_HOST', 'ftp.website.com');
정의('FTP_USER', '사용자 이름');
define('FTP_PASS', '비밀번호');

참고 : FTP_HOST, FTP_USERFTP_PASS 를 각각 웹사이트, 사용자 이름 및 비밀번호로 바꿔야 합니다.

마지막으로 다시 시도하면 WordPress를 업데이트할 수 있습니다.

5. WordPress 수동 업데이트

위의 모든 방법을 시도한 후에도 WordPress 업데이트 실패 오류가 계속 발생합니까? 이 경우 수동 업데이트가 최선의 방법일 수 있습니다.

다소 기술적이지만 보이는 것만큼 복잡하지 않습니다. WordPress는 진행 방법을 모르는 사람들을 위해 수동으로 업데이트하는 방법에 대한 자세한 가이드를 게시했습니다. 모든 지침을 올바르게 따르면 사이트를 업데이트하는 데 문제가 없습니다.

이와 같이 향후 모든 업데이트를 수동으로 적용할 필요가 없다는 점은 주목할 가치가 있습니다. 이 업데이트를 마치면 향후 모든 업데이트가 자동으로 적용되어야 하는 대로 적용됩니다.

위에서 설명한 방법을 따르면 WordPress 업데이트 실패 오류를 수정할 수 있습니다.

그러나 이것이 유일한 일반적인 문제는 아닙니다. WordPress에서 게시 실패 오류를 수정하는 방법을 살펴보겠습니다.

보너스: WordPress 게시 실패 오류를 수정하는 방법

또 다른 일반적인 오류는 WordPress 게시 실패 또는 WordPress 업데이트 실패입니다. 이 오류는 WordPress가 게시물 또는 페이지를 게시하거나 업데이트할 수 없을 때 발생합니다. 이 오류는 매우 일반적이며 사용자 사이에서 많은 불만을 야기합니다.

게시 실패 오류가 발생하는 이유는 무엇입니까?

대부분의 경우 WordPress 업데이트 실패 오류는 REST API 문제로 인해 발생합니다. 이 API는 WordPress 데이터베이스에서 보내고 받는 요청을 관리하므로 실패할 경우 사이트에 문제가 발생할 수 있습니다.

그리고 REST API 문제의 원인은 무엇입니까? 여러 가지 이유가 있을 수 있지만 가장 일반적인 원인은 연결 문제, 플러그인 또는 테마와의 충돌 또는 타사 서비스 문제입니다.

상상할 수 있듯이 이 오류는 웹사이트에 아무것도 업데이트하거나 새 게시물을 추가할 수 없기 때문에 매우 성가실 수 있습니다. 아래에서 WordPress의 게시 실패 오류를 수정하는 데 도움이 되는 솔루션 목록을 작성했습니다.

1. 인터넷 연결 및 사이트 URL 확인

대부분의 경우 WordPress는 연결 문제로 인해 게시하지 못했습니다. 인터넷 연결이 약하거나 끊어지면 게시물/페이지를 게시하거나 업데이트하지 못할 수 있으며 WordPress에 오류 메시지가 표시됩니다. 그렇기 때문에 인터넷에 안정적으로 연결되어 있는지 확인해야 합니다.

실제로 솔루션은 아니지만 게시 문제를 일으키는 가장 일반적인 원인이기 때문에 언급할 가치가 있습니다.

반면에 인터넷 연결이 제대로 작동한다면 WordPress와 사이트 URL을 확인해야 합니다. WP 관리 대시보드 로 이동하여 설정 > 일반으로 이동하면 됩니다. WordPress URL과 사이트 URL이 모두 올바른지 확인하십시오. 그렇지 않으면 문제가 발생할 수 있습니다.

WordPress에서 사이트 URL 및 WordPress 주소 URL 확인

연결 문제가 없고 URL이 정확하지만 여전히 게시 실패 오류가 발생하는 경우 다른 문제를 해결할 때입니다.

2. Site Health를 이용한 REST API 상태 확인

위에서 언급했듯이 REST API는 WordPress 및 블록 편집기와 같은 다른 응용 프로그램이 서버와 통신하는 방식입니다. REST API 문제는 게시하거나 업데이트할 때 문제를 일으킬 수 있습니다.

이 문제를 해결하는 첫 번째 단계는 REST API가 제대로 작동하는지 확인하는 것입니다. REST API가 차단되었는지 확인하는 한 가지 방법은 내장된 WordPress Site Health 도구를 사용하는 것입니다. 사용자의 주의가 필요할 수 있는 권장 사항 및 모든 문제를 표시합니다.

사이트 상태를 확인하려면 WP 관리 대시보드 로 이동하여 도구 > 사이트 상태로 이동합니다.

WordPress Site Health를 사용하여 REST API 상태 확인

REST API에 문제가 있는 경우 권장 개선 섹션 아래에 "REST API에 예기치 않은 결과가 발생했습니다."라는 문제가 표시됩니다. 메시지를 확장하면 실패한 REST API 호출의 실제 원인에 대한 세부 정보 또는 최소한 힌트가 표시됩니다. 원인을 파악하면 그에 따라 조치를 취하여 REST API를 다시 활성화할 수 있습니다.

3. 모든 플러그인 비활성화

실용적인 힌트를 얻지 못하고 실패한 REST API 호출의 원인을 찾을 수 없는 경우 모든 플러그인을 비활성화하고 문제가 해결되는지 확인할 수 있습니다. 이 이면의 아이디어는 사이트의 플러그인 중 하나가 API 호출을 방해할 수 있다는 것입니다.

플러그인을 일괄적으로 비활성화하는 방법에는 여러 가지가 있습니다. 방법을 잘 모르겠다면 가이드를 확인하세요. 가장 쉬운 방법은 WordPress 대시보드에서 모든 플러그인을 선택하고 일괄 작업을 사용하여 비활성화하는 것입니다.

WordPress의 모든 플러그인 비활성화

모든 플러그인을 비활성화한 후 게시물/페이지를 게시하거나 업데이트할 수 있는 경우 플러그인 중 하나가 문제를 일으키는 것으로 나타납니다. 그런 다음 문제를 일으키는 플러그인을 찾을 때까지 하나씩 활성화하고 게시물을 업데이트하십시오.

플러그인을 식별하면 지원 팀에 도움을 요청할 수 있습니다.

4. 디버깅 모드로 들어가기

위의 해결 방법 중 어느 것도 작동하지 않으면 WordPress 디버그 모드로 문제 해결을 시도해야 합니다. 이 모드는 wp-content 디렉토리 아래의 debug.log 파일에 모든 PHP 응답을 기록합니다. 그런 다음 로그 파일을 검사하여 REST API 호출을 차단하는 오류를 식별하고 수정 조치를 취할 수 있습니다.

디버그 모드를 활성화하려면 cPanel 또는 FTP 클라이언트를 통해 wp-config 파일을 편집해야 합니다. 메모장과 같은 텍스트 편집기를 사용하여 wp-config 파일을 열고 “/* 그게 다야, 편집을 중지하십시오! 행복한 블로깅. */”

 // WP_DEBUG 모드 활성화
정의( 'WP_DEBUG', true );

// debug.log 파일에 디버그 로깅 활성화
정의( 'WP_DEBUG_LOG', true );

디버깅 모드는 문제 해결 도구로만 사용해야 합니다. 오류를 해결했으면 wp-config 파일에서 이 줄을 제거하여 디버깅 모드를 비활성화하십시오.

5. 대체 솔루션: 클래식 편집기로 다시 전환

어떤 솔루션도 효과가 없었거나 핵심 WordPress 파일을 편집하는 데 익숙하지 않은 경우 클래식 편집기로 다시 전환해 볼 수 있습니다. WordPress 게시 실패 오류는 주로 API 호출에 의존하여 WordPress와 통신하기 때문에 새로운 블록 편집기(Guttenberg)와 관련이 있습니다.

클래식 편집기로 다시 전환하면 더 이상 게시 실패 오류가 발생하지 않습니다. 따라서 오류를 수정할 때까지 클래식 편집기로 다시 전환하는 것이 빠른 임시 해결책이 될 수 있습니다.

클래식 편집기를 설치하려면 WP 관리 대시보드 로 이동하여 플러그인 > 새로 추가로 이동합니다. Classic Editor를 검색하고 설치 버튼을 클릭한 다음 활성화합니다.

워드프레스 클래식 편집기 설치

그게 다야! 다음은 WordPress 게시 실패 오류를 수정하는 데 도움이 되는 모든 가능한 방법입니다.

결론

대체로 WordPress 업데이트는 중요한 버그 수정, 최적화 및 추가 기능을 포함하므로 매우 중요합니다. WordPress를 업데이트할 수 없으면 많은 문제가 발생할 수 있으며 중요한 기능을 놓칠 수 있습니다.

이 가이드에서는 WordPress 업데이트 실패 오류를 수정하기 위한 다양한 솔루션을 살펴보았습니다. 또한 게시 실패 오류의 원인이 무엇인지 이해하고 문제의 근본 원인에 따라 다른 해결 방법을 설명했습니다.

요약하면 이 게시물에서 우리는 다음을 보았습니다.

  • WordPress 업데이트 실패 오류를 수정하는 5가지 방법
    • .maintenance 파일 삭제
    • 적절한 파일 권한 부여
    • 안전 모드 끄기
    • wp-config 파일에 FTP 세부 정보 추가
    • 다른 모든 것이 실패하면 수동으로 WordPress 업데이트
  • WordPress 게시 실패 오류를 수정하는 5가지 방법
    • 인터넷 연결 및 사이트 URL 확인
    • WordPress 사이트 상태를 사용하여 REST API 상태 확인
    • 모든 플러그인을 비활성화한 다음 하나씩 다시 활성화
    • 디버그 모드를 입력하여 debug.log 파일 검사
    • 임시 수정 사항으로 클래식 편집기로 다시 전환

WordPress에서 가장 일반적인 문제를 해결하기 위한 추가 정보를 찾고 있다면 다음 가이드를 살펴보세요.

  • WordPress에서 "당신이 팔로우한 링크가 만료되었습니다" 오류를 수정하는 방법
  • WordPress에서 최대 실행 시간 초과 오류 수정 방법 알아보기
  • WordPress 로그인이 작동하지 않습니까? 그것을 고치는 방법

이전에 이러한 문제에 직면한 적이 있습니까? 귀하의 경험은 무엇이며 어떻게 해결했습니까? 아래 의견 섹션에 알려주십시오.