API04006: 리소스 없음
의미
서버가 요청한 리소스를 찾을 수 없습니다. 이는 일반적으로 HTTP 404 상태 코드에 해당하며, 접근하려는 제품, 주문, 고객 또는 다른 리소스가 존재하지 않음을 나타냅니다.
일반적인 원인
- 레코드 삭제 — 서버에서 리소스가 삭제됨
- 잘못된 ID — 잘못되었거나 구식 ID가 사용되고 있음
- 동기화 문제 — 로컬 데이터가 더 이상 존재하지 않는 리소스를 참조함
- URL 잘못 설정 — API 엔드포인트가 잘못됨
- 퍼머링크 문제 — 워드프레스 퍼머링크가 새로 고쳐져야 함
서버 오류 매핑
이 오류 코드는 서버가 다음을 반환할 때 발생합니다:
| 서버 코드 | 출처 |
|---|---|
rest_no_route | 워드프레스 REST API |
| HTTP 404 | 모든 서버 응답 |
수정 방법
1. 리소스 존재 여부 확인
리소스가 여전히 귀하의 WooCommerce 사이트에 존재하는지 확인합니다:
- 워드프레스 관리자에 로그인
- 관련 섹션(제품, 주문, 고객)으로 이동
- ID 또는 이름으로 항목 검색
2. 로컬 데이터 새로 고침
리소스가 서버 측에서 삭제된 경우:
- POS 설정을 엽니다
- 관련 데이터 섹션으로 이동
- 로컬 데이터를 업데이트하기 위해 동기화/새로 고침을 트리거합니다
- 삭제된 항목이 로컬에서 제거되어야 합니다
3. 워드프레스 퍼머링크 확인
여러 리소스가 발견되지 않는 경우:
- 워드프레스 관리에서 설정 → 퍼머링크로 이동
- 변경 사항 저장을 클릭합니다 (변경 없이도)
- 이로써 퍼머링크 구조가 새로 고쳐집니다
4. API 경로 확인
REST API를 직접 테스트합니다:
https://yoursite.com/wp-json/wc/v3/products
이것이 404를 반환하면 서버 구성 문제가 있을 수 있습니다.
5. 플러그인 충돌 확인
REST API 경로가 누락된 경우:
- WooCommerce가 활성화되어 있는지 확인합니다
- WCPOS 플러그인이 활성화되어 있는지 확인합니다
- 다른 플러그인을 잠시 비활성화하여 테스트합니다