지속 GraphQL 쿼리 문제 해결 troubleshoot-persisted-graphql-queries

다음 작업 센터 다음을 포함: GraphQL 지속 쿼리 오류 경고. 즉, GraphQL 지속 쿼리 중 하나에서 오류가 발생할 때마다 알림을 받습니다.

이러한 문제를 해결하고 해결할 수 있도록 다음 사항을 설명합니다. 가장 일반적이 실패의 원인과 이를 수정하는 방법에 대한 단계.

콘텐츠 조각 모델 변경 changes-to-content-fragment-model

GraphQL 지속 쿼리는 종종 기본 콘텐츠 조각 모델의 변경으로 인해 더 이상 사용되지 않는 GraphQL 유형을 기반으로 하는 경우 실패할 수 있습니다.

이것은 다양한 이유로 발생할 수 있습니다. 예를 들어 콘텐츠 모델 작성자는

  • 필드 제거 또는 이름 바꾸기
  • 조각 참조에 대해 정의된 허용된 모델을 업데이트합니다.
  • 다른 모델에서 참조하는 모델 게시 취소
  • 기타 작업 및 이유

이 문제를 해결하려면 다음 중 하나를 수행합니다.

  • 실패하는 지속 쿼리는 콘텐츠 조각 모델의 변경 사항을 수용하도록 업데이트해야 합니다
  • 또는 문제를 도입한 모델의 변경 사항을 되돌려야 합니다

GraphQL 엔드포인트가 구성되지 않음 graphql-endpoint-not-configured

지속 쿼리가 다음을 반환하는 경우 400 또는 500 오류 코드 및 정보 No suitable endpoint found즉, AEM 환경에 GraphQL 엔드포인트가 구성되지 않습니다.

이 문제를 해결하려면 다음에서 끝점을 활성화하고 게시하는 단계를 따르십시오. AEM에서 GraphQL 엔드포인트 관리.

GraphQL 지속 쿼리 URL에 경로가 누락됨 missing-path-query-url

지속 쿼리가 400 또는 500 오류 코드 및 정보 Suffix: '/' does not contain a path, GraphQL 서블릿이 경로 접미사 없이 호출되고 있습니다.

패턴은 다음과 같아야 합니다 /graphql/execute.json/thePath.

IP 허용 목록으로 인해 차단됨 blocked-due-to-ip-allow-list

이 경우 쿼리는 다음을 반환합니다. 405 오류 코드.

이는 GraphQL에만 해당되는 것이 아닙니다. 참조 자료 문서 405 오류가 허용되지 않음.

디스패처에 의해 차단됨 blocked-dispatcher

GraphQL 종단점이 다음을 반환하는 경우 404 을(를) 게시할 때 오류 발생 POST 는 GraphQL 쿼리가 dispatcher 수준에서 차단되고 끝점을 수동으로 활성화해야 함을 의미합니다.

이는 기본적으로 해당되지 않지만 사용자 지정 Dispatcher 구성으로 인해 이 문제가 발생할 수 있습니다. 아래에 자세히 보기 Dispatcher - AEM Headless를 사용한 엔드포인트 구성.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab