GraphQL 에러 처리 규칙

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

GraphQL은 여러 데이터를 한 번에 요청할 수 있기 때문에, 일부 데이터만 반환될 경우 에러를 errors 배열에 담아 전달하는 것이 특징입니다. 카카오스타일은 현재 에러 발생 시 errors 배열에 데이터를 채워 반환하지만, 여러 에러가 발생할 경우 첫 번째 에러만 유의미하게 처리하는 한계가 있습니다.

또한, 사용자 친화적인 에러 메시지 관리를 위해 서버에서 에러 메시지를 관리하고 클라이언트에게 전달하는 방식을 채택하고 있으며, 이 과정에서 다국어 처리와 같은 추가적인 고려사항이 있음을 시사합니다.