설명서CommerceCommerce KB

PWA Studio: Adobe Commerce에 대한 Venia GraphQL 쿼리에서 유효성 검사 오류가 발생했습니다.

마지막 업데이트: 2025년 5월 5일
  • 주제:

작성 대상:

  • 개발자

이 문서에서는 Adobe Commerce 인스턴스에 대한 Venia storefront GraphQL 쿼리가 유효성 검사 오류를 생성하는 문제를 해결하는 방법에 대한 권장 사항을 제공합니다.

영향을 받는 제품 및 버전

  • Adobe Commerce 온-프레미스 2.2.x, 2.3.x
  • 클라우드 인프라의 Adobe Commerce 2.2.x, 2.3.x
  • Adobe Commerce용 프로젝트 PWA Studio

문제

Adobe Commerce 온프레미스 또는 클라우드 인프라의 Adobe Commerce에 대한 Venia GraphQL 쿼리는 유효성 검사 오류를 생성합니다.

원인

문제를 일으키는 원인 중 하나는 Venia 및 해당 GraphQL 쿼리가 연결된 Adobe Commerce 인스턴스의 스키마와 동기화되지 않았기 때문일 수 있습니다.

솔루션

쿼리가 최신 상태인지 테스트하려면 프로젝트 루트에서 다음 명령을 실행합니다.

yarn run validate-queries

호환성 보고서를 표시합니다. 호환되지 않는 경우 PWA Studio 또는 Adobe Commerce 인스턴스를 업그레이드해야 합니다. 필요한 버전을 확인하려면 Adobe Commerce 호환성 매트릭스를 확인하십시오.

업그레이드 방법에 대한 지침은 다음 설명서를 참조하십시오.

  • PWA Studio 업그레이드를 위해 업그레이드해야 하는 버전에 대한 PWA 릴리스 정보의 "이전 버전에서 업그레이드" 섹션을 검색합니다.
  • 개발자 설명서에서 클라우드 인프라 버전에서 Adobe Commerce 업그레이드
  • 개발자 설명서에서 Adobe Commerce 온-프레미스 업그레이드("작성기 만들기 프로젝트" 또는 아카이브를 사용하여 설치됨)
  • 개발자 설명서에서 Adobe Commerce 온-프레미스 업그레이드(Adobe Commerce 저장소를 복제하여 설치)

관련 읽기

  • PWA Studio: 지원 기술 자료에서 컴파일을 시작하기 전에 Webpack이 중지됨
  • PWA Studio: 지원 기술 자료에서 개발자 모드를 실행할 때 유효성 검사 오류
  • PWA Studio: 브라우저가 지원 기술 자료에 "프록시할 수 없음" 오류을(를) 표시합니다.
  • 지원 기술 자료에서 PWA Studio을 사용할 수 있도록 NPM을 구성
  • Adobe Commerce 설명서 PWA
recommendation-more-help
8bd06ef0-b3d5-4137-b74e-d7b00485808a