워드프레스 The editor has encountered an unexpected error 해결하기

Table of Content

2018년 말에 워드프레스 5.0 버전이 출시되었지만 플러그인 호환성 때문에 업데이트를 미루고 있었다. 그러다가 최근 5.1 버전이 출시되었고 이 사이트에서 사용중인 대부분의 워드프레스 플러그인이 5.x 버전에서 호환되어 드디어 워드프레스 업데이트를 실시했다.

하지만 예상치 못한 문제가 생겼다. 글을 쓰거나 편집할 때 ‘The editor has encountered an unexpected error’ 라는 문제가 발생하는 것이다. 모든 플러그인을 비활성화해도 문제가 해결되지 않았다.

이 문제는 워드프레스 5.0 이후부터 본격적으로 도입된 구텐베르크 편집기 때문에 발생하는 문제인 것 같다. 그래서 고전 편집기 플러그인을 설치하여 구텐베르크 편집기 사용을 안 하면 간단하게 해결된다.

하지만 고전 편집기 지원은 언젠가 끊길 것이고(아직 구텐베르크 에디터를 반대하는 사용자가 압도적인 것으로 알고 있지만) 구텐베르크 편집기 사용을 강제할 날이 올 수 있기 때문에 이참에 새로운 편집기로 넘어가볼까 싶어 해결 방법을 알아보았다.

Amazon Lightsail Bitnami 인스턴스 기준으로 해결 방법을 설명한다. 해결 방법에 대한 설명은 깃허브 워드프레스 구텐베르크 사이트를 참고했지만 약간 다르게 바꿨다. 그 외의 시스템에선 Nginx location 설정을 아래 방법에 따라 수정해주면 될 것 같다.

 

Amazon Lightsail SSH 접속

아마존 라이트세일 사이트에 로그인 후 해당 인스턴스를 클릭하여 ‘SSH를 사용하여 연결’ 버튼을 클릭한다.

 

Nginx 설정 파일 열기

bitnami@ip-123-45-6-78: $ sudo vi /opt/bitnami/nginx/conf/bitnami/bitnami.conf


 

Nginx 설정 파일 수정

만일을 대비해서 Nginx 설정을 변경하기 전에 bitnami.conf 파일을 백업해두자.

location / 의 try_files 속성을 다음과 같이 수정한다. # HTTP Server 및 # HTTPS server 두 부분 모두 수정한다.

location / {
try_files $uri $uri/ /index.php?q=$uri&args;
}

그리고 다음 속성을 새롭게 추가한다.

location ~ ^/wp-json/ {
# if permalinks not enabled
rewrite ^/wp-json/(.*?)$ /?rest_route=/$1 last;
}

저장 후 에디터를 종료한다.

  

Nginx 재시작

bitnami@ip-123-45-6-78: # sudo /opt/bitnami/ctlscript.sh restart

이제 워드프레스 사이트에서 글을 추가하거나 입력 시 구텐베르크 에디터가 정상적으로 작동한다.

 

이 글은 워드프레스 구텐베르크 편집기로 작성한 첫 글이다. 기존 편집기와 너무 달라서 적응하기가 힘들다. 아예 못 쓸 정도로 적응하지 못하는 건 아니니 쓰다보면 자동적으로 익숙해질 듯…

 

댓글 남기기