GraphQL 에러 처리 규칙

이 글은 카카오스타일에서 GraphQL 에러를 어떻게 전달하고 처리하는지에 대한 경험을 공유합니다. Java 개발자들이 흔히 겪는 예외 처리의 어려움을 언급하며 시작합니다.

GraphQL 응답 구조에서 'errors' 배열의 중요성을 설명하고, 여러 에러 발생 시 첫 번째 에러만 처리하는 현재의 방식을 설명합니다. 'data' 필드가 null이 아니더라도 'errors' 배열에 데이터가 있으면 에러로 간주하며, 반대로 'errors' 배열에 데이터가 없으면 'data' 필드 값과 상관없이 성공으로 처리하는 규칙을 따릅니다.

또한, 사용자 친화적인 에러 메시지 관리를 위해 서버에서 메시지를 관리하고 클라이언트가 이를 그대로 표시하는 방식을 채택했으며, 이 과정에서 다국어 처리의 필요성을 제기합니다.