API04001: 잘못된 응답 형식
의미
서버가 응답했지만 응답 형식이 POS가 기대했던 것이 아닙니다. 서버는 JSON 데이터를 반환해야 하지만 다른 것이 수신되었습니다.
일반적인 원인
- PHP 오류가 표시됨 — JSON 이전에 PHP 오류가 출력되고 있습니다.
- 플러그인 충돌 — 다른 플러그인이 콘텐츠를 출력하고 있습니다.
- 유지 관리 모드 — 사이트가 유지 관리 페이지를 표시하고 있습니다.
- 잘못된 콘텐츠 유형 — 서버가 JSON 대신 HTML을 보내고 있습니다.
- 캐싱 문제 — 캐시된 오류 페이지가 제공되고 있습니다.
수정 방법
1. 사이트 확인
브라우저에서 WordPress 사이트를 방문하세요:
- 정상적으로 표시되나요?
- 보이는 오류가 있나요?
- 유지 관리 모드인가요?
2. PHP 오류 확인
wp-config.php에서 디버깅을 임시로 활성화하세요:
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
wp-content/debug.log에서 오류를 확인하세요.
3. REST API 직접 테스트
브라우저에서 https://yoursite.com/wp-json/를 방문하세요:
- JSON 데이터를 반환해야 합니다.
- HTML 또는 오류를 보면 문제가 있습니다.
- 플러그인 관련 출력을 확인하세요.
4. 캐싱 임시 비활성화
캐싱 플러그인이 만료된 응답을 제공할 수 있습니다:
- 모든 캐시를 지우세요.
- 캐싱 플러그인을 임시로 비활성화하세요.
- REST API를 캐싱에서 제외하세요.
5. 플러그인 충돌 확인
플러그인이 모든 페이지에서 콘텐츠를 출력하는 경우:
- 필수하지 않은 모든 플러그인을 비활성화하세요.
- POS를 테스트하세요.
- 플러그인을 하나씩 다시 활성화하세요.