Styxis
Company
Knowledge

Shopify metafield 필터 오류: 빈 성공 결과로 숨기지 않기

새 필터의 실패는 실제 결과 없음과 다르므로 응답 상태와 자료 집합을 함께 시험해야 한다.

Shopify metafield 필터 오류: 빈 성공 결과로 숨기지 않기

필터 조건을 실행할 수 없다는 오류와 실행 결과가 비었다는 성공은 서로 다른 업무 정보다. API가 이전에 무시하던 조건을 오류로 바꿨다면 adapter의 기존 처리도 다시 확인해야 한다. 오류를 무조건 빈 목록으로 반환하면 자료가 없다는 잘못된 결론을 소비자에게 전달할 수 있다. [1, 2, 3]

공개 원문이 보여 준 범위

Shopify는 필터링할 수 없는 metafield 조건을 무시하는 대신 오류를 반환하는 API 변경을 공지했다. 정의·filtering 설정·지원 비교 연산을 확인하고 이전 버전의 동작과 구분한다. 이 오류 계약은 API 2026-10부터 적용된다. [1]

입력과 출력에서 확인할 관계

유효 필터, 미정의 metafield 필터, 지원하지 않는 비교를 각각 시험한다. adapter가 오류를 빈 성공 응답으로 바꾸지 않는지 확인하고 filter_definition_state, api_version, response_kind, returned_count를 함께 남긴다. 이렇게 해야 연동 조건의 오류를 자료가 없다는 업무 사실로 잘못 보고하지 않는다. [1, 3]

승인 기준과 실패 사례

설명용 조건은 필터링이 허용되지 않은 metafield를 사용하므로 응답 상태를 error로 유지해야 한다. empty_success로 바꾸면 실행할 수 없는 질의를 정상적인 무결과 질의처럼 전달하므로 실패다. 유효한 질의에 실제 매칭이 없어 빈 결과가 나온 경우는 다르다. 같은 행수만으로 이 두 상태를 합치지 않는 것이 검사의 핵심이다. [1, 3]

Truthound를 연결하는 검사 경계

Truthound Core 3.3.2의 ColumnPairValidator는 필터 조건에서 기대한 response_kind와 adapter가 기록한 상태를 비교할 수 있다. GraphQL 요청 실행과 errors 해석은 adapter의 책임이다. 빈 자료를 뜻하는 성공 상태와 실행할 수 없는 조건의 오류 상태를 같은 행수로 합치지 않는다. [1, 2, 3]

다른 선택이 필요한 조건

오류 처리 검사가 필터 논리나 반환한 개별 자원의 업무 적합성까지 증명하지 않는다. 정의와 지원 비교를 사전 확인하고 오류 응답을 운영 점검 경로로 분리한다. 정의·설정·비교가 모두 유효한 쿼리의 실제 빈 결과는 정상일 수 있다. [1, 3]

적용 조건

filter_definition_state, api_version, response_kind, returned_count 표를 원시 입력과 승인 기준에서 각각 준비하고 행 식별자를 유지한다.

대안

정의와 지원 비교를 사전 확인하고 오류 응답을 운영 점검 경로로 분리한다.

한계

  • 오류 처리 검사가 필터 논리나 반환한 개별 자원의 업무 적합성까지 증명하지 않는다.

근거

사건 확인일
대상 확인일
수정일