워드프레스 '응답이 올바른 JSON 응답이 아닙니다' 오류 해결 방법 (+SureRank SEO 플러그인 & 가비아 호스팅)

일부 웹호스팅이나 워드프레스 환경에서 글을 작성하거나 업데이트하거나 혹은 플러그인 설정을 저장할 때 '응답이 올바른 JSON 응답이 아닙니다' 오류가 발생하면서 저장이 안 될 때가 있습니다. 이 오류는 REST API를 사용하여 데이터를 저장하는 워드프레스 블록 에디터나 플러그인에서 서버로부터 JSON 형식이 아닌 응답을 받을 때 발생합니다. 임시방편으로 클래식 에디터를 설치하면 글쓰기가 가능해지지만, REST API를 사용하는 플러그인이 있다면 문제가 해결되지 않기 때문에 근본적인 원인을 찾아 해결해야 합니다.

1. 이 오류의 의미

이 오류 자체는 워드프레스가 서버에 REST API 요청을 보냈지만 서버로부터 JSON 형식이 아닌 응답을 받았다는 뜻입니다.

워드프레스 버전 5.0부터 기본 편집기로 통합된 블록 에디터(구텐베르크)와 대부분의 모던한 플러그인은 데이터를 저장할 때 REST API(/wp-json/)를 사용합니다. 이 요청에 대한 응답은 반드시 JSON 형식이어야 하는데, 서버가 아래와 같은 것을 반환하면 이 오류가 발생합니다.

• HTML 에러 페이지 (400, 403, 500 등)
• PHP 에러/경고 메시지
• 빈 응답

2. 가비아에서 잘못된 JSON 응답 오류가 발생하는 경우

SureRank라는 SEO 플러그인이 설치된 워드프레스 사이트에서 SureRank SEO 플러그인의 설정을 저장하면 'Failed to save settings. 응답이 올바른 JSON 응답이 아닙니다' 에러가 발생하면서 설정이 저장되지 않는 문제가 발생했습니다.

이 오류는 REST API와 관련이 있기 때문에 블록 에디터에서 글을 작성한 후에 저장할 때에도 동일한 에러가 발생하게 됩니다.

해당 사이트에서는 글을 저장할 때 '응답이 유효한 JSON 응답이 아닙니다' 오류가 발생하지 않았는데, 살펴보니 클래식 에디터(고전 편집기)가 설치되어 있었습니다.

클래식 편집기를 설치하면 블록 에디터 대신 기존의 고전 편집기를 사용하여 글을 작성하게 됩니다. 클래식 편집기는 블록 에디터(구텐베르크 편집기)로 옮겨가는 과정에서 임시로 사용하도록 만들어진 과도기적 성격의 플러그인입니다. 지금은 블록 에디터의 기능이 크게 향상되었기 대문에 가급적 블록 에디터를 사용하는 것이 바람직한 것 같습니다. (요즘 나오는 다수의 플러그인이 REST API를 사용하기 때문에 REST API와 통신하는 데 문제가 있으면 사이트가 제대로 작동하지 않을 수 있습니다.)

해당 사이트에서 콘솔 오류 메시지를 체크해 보았습니다.

브라우저 개발자 도구로 확인한 결과를 바탕으로 원인이 Apache LimitRequestFieldSize 쿠키 크기가 초과되어 발생하는 것으로 추정되었습니다. (결과적으로 잘못된 진단되었습니다.😥)

• REST API POST 요청 시 Apache가 워드프레스에 전달하기 전에 400 반환
• 응답이 text/html; charset=iso-8859-1,226 bytes의 Apache 기본 에러 페이지
• 쿠키 헤더에 wordpress_logged_in_ 등 긴 값들이 포함되어 Apache 기본 제한값인 8,190 bytes를 초과한 것으로 추정

하지만 이번 건은 가비아 서버 프런트엔드에 설치된 웹 방화벽이 워드프레스 REST API POST 요청을 악성 요청으로 오인하여 차단한 것이었습니다. 웹 방화벽이 차단할 때도 Apache 기본 400 에러 페이지를 그대로 반환하기 때문에 겉으로 보이는 증상이 동일하여 초기에 구분이 어려웠습니다.

가비아에 연락하니 "웹 방화벽 영향으로 증상이 발생한 것으로 추정"되어 방화벽 설정을 최소한으로 변경했다는 답변을 받았습니다.

다행히 가비아 담당자가 서버 병화벽을 최소한으로 변경한 후에 문제가 해결되었습니다.

동일한 문제가 발생한다면 먼저 웹호스팅 업체에 연락하면 서버 방화벽을 변경하거나 서버 설정을 변경하는 등 조치를 취해줄 수도 있습니다.

이용하는 사이트에는 PHP 7.4가 적용되어 있었고 PHP 버전을 업그레이드할 수 없는 상태였습니다. 당분간 PHP 버전을 이용할 수 있지만, 워드프레스가 업데이트되면서 구 버전의 PHP 호환성을 단종시키는 조치를 취하고 있습니다. 또한, 사이트 속도와 보안을 위해서는 PHP 버전을 업그레이드하는 것이 바람직해 보입니다. 카페24나 클라우드웨이즈와 같은 호스팅으로 이용하면 PHP 8.4까지 현재 지원합니다.

Q&A (질문과 답변)

Q1. 워드프레스에서 "응답이 올바른 JSON 응답이 아닙니다" 오류가 발생하는 가장 흔한 원인은 무엇인가요?

A. 가장 흔한 원인은 호스팅사의 웹 방화벽(WAF)이 REST API 요청을 악성 요청으로 오인하여 차단하는 경우입니다. 특히 가비아 등 일부 국내 공유호스팅 환경에서 자주 발생합니다. 브라우저 개발자 도구(F12) → Network 탭에서 실패한 요청의 Response를 확인했을 때 Apache 기본 400 에러 페이지가 보인다면 웹 방화벽 차단을 가장 먼저 의심하세요.

Q2. 클래식 에디터(Classic Editor)를 설치하면 이 오류가 해결되나요?

A. 블록 에디터에서 글을 작성하거나 업데이트할 때 저장 문제는 해결됩니다. 클래식 편집기가 REST API 대신 전통적인 admin-ajax.php 방식으로 글을 저장하기 때문입니다. 그러나 SureRank, Yoast SEO, 엘리멘터(Elementor), 우커머스 등 REST API를 사용하는 다른 플러그인은 여전히 동일한 오류가 발생할 수 있어 근본적인 해결책은 아닙니다.

Q3. 가비아 공유호스팅을 사용 중인데 어떻게 해결하나요?

A. 가비아 고객센터에 웹 방화벽 예외 처리를 요청하시면 됩니다. 문의 시 오류가 발생하는 URL(/wp-json/ 경로)과 증상을 구체적으로 설명하고, 담당자 요청 시 본인 PC의 공인 IP(네이버에서 "내 IP 주소 확인" 검색)를 함께 제공하면 더 빠르게 처리됩니다. 실제로 가비아 측에서 방화벽 설정을 조정한 후 문제가 해결된 적이 있습니다.

Q4. 이 오류가 발생했을 때 가장 먼저 해야 할 진단 방법은 무엇인가요?

A. 브라우저 개발자 도구(F12) → 네트워크 탭을 열고 오류가 발생하는 동작(설정 저장 등)을 실행한 후, 빨간색으로 표시된 실패한 요청을 클릭하여 Response 탭의 내용을 확인하세요. HTML 에러 페이지가 반환되면 서버 단에서 차단된 것이고, PHP 에러 메시지가 포함되어 있으면 PHP 설정 문제입니다. 또한, 브라우저에서 https://내도메인/wp-json/에 직접 접속했을 때 JSON 응답이 오면 REST API 자체는 정상이므로 플러그인·테마 충돌을 의심해 볼 수 있습니다.

참고

https://avada.tistory.com/3934

카페24 SSL 인증서 오류 때문에 워드프레스 관리자 페이지에 로그인되지 않는 문제

https://avada.tistory.com/3924

가비아에서 클라우드웨이즈로 워드프레스 이전 시 이모지(이모티콘) 깨짐 문제 해결

https://avada.tistory.com/3046

해외웹호스팅: 클라우드웨이즈 vs. 블루호스트 vs. 카페24 비교 (Cloudways vs. Bluehost vs. Cafe24)