DB 스키마 캐시 조회 실패 오류 해결
MCP 1.9.9 기준 · 2026-10-07 검토. 오류의 원인과 해결 담당, 복구 후 확인할 조건을 안내합니다. 기존 원본·승인 대본·목소리·타이밍·진행 중 작업을 보존합니다.
해결 담당: 서비스 운영자 또는 해당 기능 담당자가 발생 조건을 확인해야 합니다.
어떻게 복구하나요?
- PGRST002는 API가 스키마 캐시를 읽지 못한 오류다. 고객의 입력이나 크레딧 부족으로 처리하지 않는다. 오류 시각·기존 작업 ID·Modal task/input/functionCall ID를 보존하고 같은 작업 상태를 조회한다.
- DB 상태, PostgREST 로그, Exposed schemas의 실제 존재 여부를 확인한다. 일시 장애이면 안전한 조회만 제한된 횟수로 재시도한다. 존재하지 않는 노출 스키마가 원인이면 운영자가 설정을 바로잡고 캐시 갱신 후 조회를 확인한다. 원인을 확인하지 않고 스키마 삭제·권한 확대를 하지 않는다.
- 예약 reconcile은 제공사 호출 없는 기존 작업 정리다. 해당 함수만 최대 3회 같은 RPC를 조회하며 계속 실패하면 실패 상태와 호출 ID를 남긴다. 영상 생성·결제·접수 결과 불명의 쓰기 작업에는 이 재시도를 적용하지 않는다.
해결됐는지 확인하기
- 같은 API 또는 예약 정리 함수가 정상 응답하며 실패가 재발하지 않는지 확인한다.
- 생성 성공·렌더 성공은 해당 job 상태와 실제 결과를 별도로 검수한다.
성공 조건을 확인한 뒤 같은 프로젝트·run의 실패한 단계부터 이어갑니다. 유료 작업은 기존 접수·승인 범위를 다시 대조합니다.
해당 오류 코드
아래 코드는 이 절차를 공유합니다. 구체적인 원인 필드와 발생 조건은 코드별로 다르므로 AI가 설치본에서 해당 코드의 상세 항목을 읽어야 합니다.
PGRST002
이 오류의 검증 조건은 코드별 상세 문서의 발생 위치에서 확인합니다.
복구 검증: 복구 분기 테스트 통과 (운영 결과 별도 확인)
위 복구 순서에 따라 현재 입력과 저장 상태를 확인하고, 성공 조건을 충족한 뒤 기존 작업을 이어갑니다.
AI에게 “PGRST002의 코드별 복구 문서를 읽고, 기존 프로젝트에서 해당 조건을 확인해줘”라고 요청하세요.
작업 ID와 복구 이력
AI가 실패하면 오류 코드와 기존 작업 ID를 기록하고 같은 작업의 상태부터 확인합니다. MCP 오류 기록은 같은 컴퓨터에서 다시 읽을 수 있습니다. 고객에게 내부 ID나 크레딧 사용량을 다시 입력하게 하지 않습니다. 작업 ID·고객 자료는 이 공개 사전에 게시하지 않습니다.